"

 COPYRIGHT (c) 2004 by eXept Software AG

              All Rights Reserved

 This software is furnished under a license and may be used

 only in accordance with the terms of that license and with the

 inclusion of the above copyright notice.   This software may not

 be provided or otherwise made available to, or used by, any

 other person.  No title to or ownership of the software is

 hereby transferred.

"

"{ Package: 'stx:libbasic2' }"

"{ NameSpace: Smalltalk }"

CharacterArray variableLongSubclass:#FourByteString

	instanceVariableNames:''

	classVariableNames:''

	poolDictionaries:''

	category:'Collections-Text'

!

!FourByteString class methodsFor:'documentation'!

copyright

"

 COPYRIGHT (c) 2004 by eXept Software AG

              All Rights Reserved

 This software is furnished under a license and may be used

 only in accordance with the terms of that license and with the

 inclusion of the above copyright notice.   This software may not

 be provided or otherwise made available to, or used by, any

 other person.  No title to or ownership of the software is

 hereby transferred.

"

!

documentation

"

    FourByteStrings are like strings, but storing 32bits per character.

    The integration of them into the system is not completed ....

    [author:]

        Claus Gittinger

    [see also:]

        Text TwoByteString UnicodeEncodedString

        StringCollection

"

! !

!FourByteString class methodsFor:'initialization'!

initialize

    "initialize the class - private"

    self flags:(Behavior flagLongs)

    "

     FourByteString initialize

    "

    "Modified: 22.4.1996 / 16:14:14 / cg"

! !

!FourByteString class methodsFor:'instance creation'!

basicNew:anInteger

    "return a new empty string with anInteger characters"

    ^ (super basicNew:anInteger) atAllPut:(Character space)

    "Modified: 26.2.1996 / 14:38:47 / cg"

!

uninitializedNew:anInteger

    "return a new empty string with anInteger characters"

    ^ super basicNew:anInteger

    "

        self uninitializedNew:10

    "

! !

!FourByteString methodsFor:'accessing'!

basicAt:index

    "return the character at position index, an Integer

     - reimplemented here since we return 32-bit characters"

    |val|

    val := super basicAt:index.

    ^ Character value:val

!

basicAt:index put:aCharacter

    "store the argument, aCharacter at position index, an Integer.

     Returns aCharacter (sigh).

     - reimplemented here since we store 32-bit characters"

    |val|

    val := aCharacter codePoint.

    super basicAt:index put:val.

    ^ aCharacter

! !

!FourByteString methodsFor:'filling and replacing'!

from:start to:stop put:aCharacter

    "fill part of the receiver with aCharacter.

     - reimplemented here for speed"

%{  /* NOCONTEXT */

    REGISTER unsigned int *dstp;

    REGISTER int count, charValue;

    int len, index1, index2;

    OBJ cls;

    // fprintf(stderr, "fill32...\n");

    if (__isCharacter(aCharacter)

     && __bothSmallInteger(start, stop)) {

        len = __unicode32StringSize(self);

        index1 = __intVal(start);

        index2 = __intVal(stop);

        dstp = __unicode32StringVal(self) + index1 - 1;

        if ((cls = __qClass(self)) != @global(Unicode32String)) {

            int nInst;

            nInst = __OBJS2BYTES__(__intVal(__ClassInstPtr(cls)->c_ninstvars));

            dstp += nInst;

            len -= nInst;

        }

        charValue = __intVal(__characterVal(aCharacter));

        if (((unsigned)charValue <= 0x0FFFFFFF)

         && (index1 <= index2)

#if (__POINTER_SIZE__ == 8)

                while (count >= 8) {

                    dstp += 8;

                    count -= 8;

                }

                    *dstp++ = charValue;

                }

            }

        }

    }

%}.

    "

     fall back in case of non-integer index or out-of-bound index/value;

     will eventually lead to an out-of-bound signal raise

    "

    ^ super from:start to:stop put:aCharacter

    "

     (Unicode16String new:10) from:1 to:10 put:$a

     (Unicode16String new:20) from:10 to:20 put:$b

     (Unicode16String new:20) from:1 to:10 put:$c

     (Unicode16String new:20) from:1 to:10 put:$c 

     (Unicode16String new:100) from:2 to:99 put:$c 

     (Unicode16String new:10) from:0 to:9 put:$a

     (Unicode16String new:10) from:1 to:11 put:$a

    "

    "Created: / 26-03-2019 / 11:30:51 / Claus Gittinger"

! !

!FourByteString methodsFor:'queries'!

bitsPerCharacter

    "return the number of bits each character has.

     Here, 32 is returned (storing quad byte characters)."

    ^ 32

!

bytesPerCharacter

    "return the number of bytes each character has.

     Here, 4 is returned (storing quad byte characters)."

    ^ 4

!

isWideString

    "true if I require more than one byte per character"

    ^ true

! !

!FourByteString methodsFor:'testing'!

isSingleByteCollection

    "return true, if the receiver has access methods for bytes;

     i.e. #at: and #at:put: accesses a byte and are equivalent to #byteAt: and byteAt:put:

     and #replaceFrom:to: is equivalent to #replaceBytesFrom:to:. 

     false is returned here since at: returns 4-byte characters and not bytes 

      - the method is redefined from UninterpretedBytes."

    ^ false

    "Created: / 30-08-2017 / 23:31:02 / cg"

! !

!FourByteString class methodsFor:'documentation'!

version

    ^ '$Header$'

! !

FourByteString initialize!