LongIntegerArray.st
author Claus Gittinger <cg@exept.de>
Thu, 09 Jun 2016 17:01:18 +0200
changeset 3918 c565bdb0c8c4
parent 3875 49fa81cfbead
permissions -rw-r--r--
#OTHER by cg class: LinkedList changed: #at:ifAbsent:
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
703
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     1
"
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     2
 COPYRIGHT (c) 1998 by Claus Gittinger / eXept Software AG
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     3
	      All Rights Reserved
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     4
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     5
 This software is furnished under a license and may be used
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     6
 only in accordance with the terms of that license and with the
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     7
 inclusion of the above copyright notice.   This software may not
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     8
 be provided or otherwise made available to, or used by, any
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     9
 other person.  No title to or ownership of the software is
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    10
 hereby transferred.
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    11
"
1177
f81425b27be5 inheritance & documentation
Claus Gittinger <cg@exept.de>
parents: 736
diff changeset
    12
"{ Package: 'stx:libbasic2' }"
f81425b27be5 inheritance & documentation
Claus Gittinger <cg@exept.de>
parents: 736
diff changeset
    13
3730
bf8581dca827 #FEATURE
Stefan Vogel <sv@exept.de>
parents: 3331
diff changeset
    14
"{ NameSpace: Smalltalk }"
bf8581dca827 #FEATURE
Stefan Vogel <sv@exept.de>
parents: 3331
diff changeset
    15
1177
f81425b27be5 inheritance & documentation
Claus Gittinger <cg@exept.de>
parents: 736
diff changeset
    16
UnboxedIntegerArray variableLongLongSubclass:#LongIntegerArray
703
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    17
	instanceVariableNames:''
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    18
	classVariableNames:''
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    19
	poolDictionaries:''
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    20
	category:'Collections-Arrayed'
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    21
!
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    22
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    23
!LongIntegerArray class methodsFor:'documentation'!
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    24
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    25
copyright
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    26
"
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    27
 COPYRIGHT (c) 1998 by Claus Gittinger / eXept Software AG
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    28
	      All Rights Reserved
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    29
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    30
 This software is furnished under a license and may be used
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    31
 only in accordance with the terms of that license and with the
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    32
 inclusion of the above copyright notice.   This software may not
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    33
 be provided or otherwise made available to, or used by, any
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    34
 other person.  No title to or ownership of the software is
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    35
 hereby transferred.
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    36
"
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    37
!
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    38
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    39
documentation
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    40
"
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    41
    LongIntegerArrays store 64bit unsigned integers in the range 
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    42
    0..16rFFFFFFFFFFFFFFFF.
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    43
    In contrast to normal arrays (which store pointers to their elements),
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    44
    longIntegerArrays store the values in a dense & compact way. 
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    45
    Since the representation fits the underlying C-language systems representation
1177
f81425b27be5 inheritance & documentation
Claus Gittinger <cg@exept.de>
parents: 736
diff changeset
    46
    of unsigned longlong's, this is also useful to pass bulk data to c primitive code.
704
140e6119a3d7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 703
diff changeset
    47
    (the system makes certain, that the first longlong is aligned as required)
703
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    48
736
db164846b078 documentation
Claus Gittinger <cg@exept.de>
parents: 704
diff changeset
    49
    [memory requirements:]
db164846b078 documentation
Claus Gittinger <cg@exept.de>
parents: 704
diff changeset
    50
        OBJ-HEADER + (size * 8)
db164846b078 documentation
Claus Gittinger <cg@exept.de>
parents: 704
diff changeset
    51
703
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    52
    [see also:]
736
db164846b078 documentation
Claus Gittinger <cg@exept.de>
parents: 704
diff changeset
    53
        ByteArray BooleanArray FloatArray DoubleArray Array
db164846b078 documentation
Claus Gittinger <cg@exept.de>
parents: 704
diff changeset
    54
        WordArray SignedWordArray IntegerArray SignedIntegerArray
db164846b078 documentation
Claus Gittinger <cg@exept.de>
parents: 704
diff changeset
    55
        SignedLongIntegerArray
703
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    56
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    57
    [author:]
736
db164846b078 documentation
Claus Gittinger <cg@exept.de>
parents: 704
diff changeset
    58
        Claus Gittinger
703
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    59
"
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    60
! !
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    61
2644
64929c24382b faster elementByteSize query
Claus Gittinger <cg@exept.de>
parents: 1177
diff changeset
    62
!LongIntegerArray class methodsFor:'queries'!
64929c24382b faster elementByteSize query
Claus Gittinger <cg@exept.de>
parents: 1177
diff changeset
    63
64929c24382b faster elementByteSize query
Claus Gittinger <cg@exept.de>
parents: 1177
diff changeset
    64
elementByteSize
3331
91281fa924b9 class: WordArray
Claus Gittinger <cg@exept.de>
parents: 2644
diff changeset
    65
    "for bit-like containers, return the number of bytes stored per element.
91281fa924b9 class: WordArray
Claus Gittinger <cg@exept.de>
parents: 2644
diff changeset
    66
     Here, 8 is returned"
91281fa924b9 class: WordArray
Claus Gittinger <cg@exept.de>
parents: 2644
diff changeset
    67
2644
64929c24382b faster elementByteSize query
Claus Gittinger <cg@exept.de>
parents: 1177
diff changeset
    68
    ^ 8
64929c24382b faster elementByteSize query
Claus Gittinger <cg@exept.de>
parents: 1177
diff changeset
    69
64929c24382b faster elementByteSize query
Claus Gittinger <cg@exept.de>
parents: 1177
diff changeset
    70
    "Created: / 15-09-2011 / 14:11:59 / cg"
3730
bf8581dca827 #FEATURE
Stefan Vogel <sv@exept.de>
parents: 3331
diff changeset
    71
!
bf8581dca827 #FEATURE
Stefan Vogel <sv@exept.de>
parents: 3331
diff changeset
    72
bf8581dca827 #FEATURE
Stefan Vogel <sv@exept.de>
parents: 3331
diff changeset
    73
maxVal
3875
49fa81cfbead #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 3864
diff changeset
    74
    "the maximum value which can be stored in instances of me.
49fa81cfbead #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 3864
diff changeset
    75
     For LongIntegerArrays, this is 18446744073709551615 eg. 16rFFFFFFFFFFFFFFFF 
49fa81cfbead #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 3864
diff changeset
    76
     (largest 64bit unsigned int)"
3864
e8dce3d3018b #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 3730
diff changeset
    77
3730
bf8581dca827 #FEATURE
Stefan Vogel <sv@exept.de>
parents: 3331
diff changeset
    78
    ^ 16rFFFFFFFFFFFFFFFF
3864
e8dce3d3018b #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 3730
diff changeset
    79
!
e8dce3d3018b #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 3730
diff changeset
    80
e8dce3d3018b #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 3730
diff changeset
    81
minVal
3875
49fa81cfbead #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 3864
diff changeset
    82
    "the minimum value which can be stored in instances of me.
49fa81cfbead #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 3864
diff changeset
    83
     For LongIntegerArrays, this is 0"
3864
e8dce3d3018b #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 3730
diff changeset
    84
e8dce3d3018b #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 3730
diff changeset
    85
    ^ 0
2644
64929c24382b faster elementByteSize query
Claus Gittinger <cg@exept.de>
parents: 1177
diff changeset
    86
! !
64929c24382b faster elementByteSize query
Claus Gittinger <cg@exept.de>
parents: 1177
diff changeset
    87
703
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    88
!LongIntegerArray class methodsFor:'documentation'!
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    89
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    90
version
3730
bf8581dca827 #FEATURE
Stefan Vogel <sv@exept.de>
parents: 3331
diff changeset
    91
    ^ '$Header$'
3875
49fa81cfbead #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 3864
diff changeset
    92
!
49fa81cfbead #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 3864
diff changeset
    93
49fa81cfbead #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 3864
diff changeset
    94
version_CVS
49fa81cfbead #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 3864
diff changeset
    95
    ^ '$Header$'
703
a0a2d6178de4 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    96
! !
3331
91281fa924b9 class: WordArray
Claus Gittinger <cg@exept.de>
parents: 2644
diff changeset
    97