|
Class: Unicode16String
Object
|
+--Collection
|
+--SequenceableCollection
|
+--ArrayedCollection
|
+--UninterpretedBytes
|
+--CharacterArray
|
+--TwoByteString
|
+--Unicode16String
- Package:
- stx:libbasic
- Category:
- Collections-Text
- Version:
- rev:
1.28
date: 2019/05/28 12:46:30
- user: stefan
- file: Unicode16String.st directory: libbasic
- module: stx stc-classLibrary: libbasic
Represents 16-bit (2-byte) Unicode strings.
initialization
-
initialize
-
initialize the class - private
usage example(s):
Unicode16String initialize
|
reading
-
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
|
conversion
-
asUnicode16String
-
as the receiver already is a unicode-16 string, return it
-
asUnicodeString
-
as the receiver already is a unicode string, return it
-
utf16Encoded
-
have to encode only if there are characters that are outside the UTF-16 range
usage example(s):
((Unicode16String new:1) at:1 put:16rD800; yourself) utf16Encoded
((Unicode16String new:1) at:1 put:16r2A00; yourself) utf16Encoded
|
printing & storing
-
displayOn: aGCOrStream
-
display myself as on aStream.
You must use an ISO10646 unicode font to display this string
-
printOn: aStream
-
print the receiver on aStream.
Let aStream decide how to represent this, whether utf8, ucs16, ...
-
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
].
|
-
storeString
-
return a String for storing myself
usage example(s):
'hello' asUnicodeString storeString
'hello -öäüß' storeString
'hello -öäüß' asUnicodeString storeString
|
-
unicodeStoreOn: aStream
-
put the storeString of myself on aStream
-
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
-
isUnicode16String
-
-
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
|