eXept Software AG Logo

Smalltalk/X Webserver

Documentation of class 'Unicode16String':

Home

Documentation
www.exept.de
Everywhere
for:
[back]

Class: Unicode16String


Inheritance:

   Object
   |
   +--Collection
      |
      +--SequenceableCollection
         |
         +--ArrayedCollection
            |
            +--UninterpretedBytes
               |
               +--CharacterArray
                  |
                  +--TwoByteString
                     |
                     +--Unicode16String

Package:
stx:libbasic
Category:
Collections-Text
Version:
rev: 1.27 date: 2017/02/22 18:02:13
user: cg
file: Unicode16String.st directory: libbasic
module: stx stc-classLibrary: libbasic

Description:


Represents 16-bit (2-byte) Unicode strings.


Class protocol:

initialization
o  initialize
initialize the class - private
usage example(s):
     Unicode16String initialize

reading
o  readFrom: aStreamOrString onError: exceptionBlock
read & return the next String from the (character-)stream aStream;
skipping all whitespace first; return the value of exceptionBlock,
if no string can be read. The sequence of characters as read from the
stream must be one as stored via storeOn: or storeString.
usage example(s):
        self readFrom:'abc' storeString


Instance protocol:

conversion
o  asUnicode16String
as the receiver already is a unicode-16 string, return it

o  asUnicodeString
as the receiver already is a unicode string, return it

printing & storing
o  displayOn: aGCOrStream
display myself as on aStream.
You must use an ISO10646 unicode font to display this string

o  printOn: aStream
print the receiver on aStream.
Let aStream decide how to represent this, whether utf8, ucs16, ...

o  storeOn: aStream
put the storeString of myself on aStream
usage example(s):
        String streamContents:[:s|
            'hello' asUnicodeString storeOn:s
        ].

        String streamContents:[:s|
            'hello -' asUnicodeString storeOn:s
        ].

o  storeString
return a String for storing myself
usage example(s):
        'hello' asUnicodeString storeString
        'hello -' storeString
        'hello -' asUnicodeString storeString

o  unicodeStoreOn: aStream
put the storeString of myself on aStream

o  unicodeStoreString
return a UnicodeString for storing myself.
This method is a kind of kludge.
Use it when you want to write a storeString to an encoded Stream

testing
o  isUnicode16String

o  isUnicodeString
true if this is a 2- or 4-byte unicode string
(i.e. not a single byte string).
Notice, that the name is misleading:
all strings are use unicode encoding



ST/X 7.1.0.0; WebServer 1.663 at exept.de:8081; Fri, 22 Mar 2019 10:05:39 GMT