Class: ISO10646_to_XMLUTF8 (in CharacterEncoderImplementations)

• Inheritance
• Description
• Class protocol
  • initialization
  • queries
• Instance protocol
  • encoding & decoding
  • queries

Inheritance:

   Object
   |
   +--CharacterEncoder
      |
      +--CharacterEncoderImplementations::VariableBytesEncoder
         |
         +--CharacterEncoderImplementations::ISO10646_to_UTF8
            |
            +--CharacterEncoderImplementations::ISO10646_to_XMLUTF8

Package:

stx:libbasic

Category:

Collections-Text-Encodings

Version:

rev: 1.4 date: 2018/01/04 00:12:44

user: stefan

file: CharacterEncoderImplementations__ISO10646_to_XMLUTF8.st directory: libbasic

module: stx stc-classLibrary: libbasic

Description:

This encoder encodes characters into utf8 characters that may
occur in XML document.

Not all UTF characters are valid in XML, whatever encoding
is used. For a reference, see 

  https://www.w3.org/TR/xml/#NT-Char

Invalid characters are replaced by ReplacementCharacter
with $? as default.


[instance variables:]

[class variables:]

copyright
COPYRIGHT (c) 2006 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.

Class protocol:

 initialize

Invoked at system start or when the class is dynamically loaded.

 isValidXMLunicode: codePoint

Returns true, if given codePoint (Integer!!!) is
valid XML unicode.

Instance protocol:

 encodeCharacter: aUnicodeCharacter on: aStream

return the UTF-8 representation of a aUnicodeCharacter.
The resulting string contains only valid XML unicode
characters. Invalid characters are replaced by a
ReplacementCharacter. For details, please see

https://www.w3.org/TR/xml/#NT-Char

 encodeString: aUnicodeString

return the UTF-8 representation of a aUnicodeString.
The resulting string contains only valid XML unicode
characters. Invalid characters are replaced by a
ReplacementCharacter. For details, please see

https://www.w3.org/TR/xml/#NT-Char

Usage example(s):

(self encodeString:'hello') asByteArray #[104 101 108 108 111] (self encodeString:(Character value:16r40) asString) asByteArray #[64] (self encodeString:(Character value:16r7F) asString) asByteArray #[127] (self encodeString:(Character value:16r80) asString) asByteArray #[194 128] (self encodeString:(Character value:16rFF) asString) asByteArray #[195 191] (self encodeString:(Character value:16r100) asString) asByteArray #[196 128] (self encodeString:(Character value:16r200) asString) asByteArray #[200 128] (self encodeString:(Character value:16r400) asString) asByteArray #[208 128] (self encodeString:(Character value:16r800) asString) asByteArray #[224 160 128] (self encodeString:(Character value:16r1000) asString) asByteArray #[225 128 128] (self encodeString:(Character value:16r2000) asString) asByteArray #[226 128 128] (self encodeString:(Character value:16r4000) asString) asByteArray #[228 128 128] (self encodeString:(Character value:16r8000) asString) asByteArray #[232 128 128] (self encodeString:(Character value:16rFFFF) asString) '?'

 encodeString: aUnicodeString on: aStream

return the UTF-8 representation of a aUnicodeString.
The resulting string contains only valid XML unicode
characters. Invalid characters are replaced by a
ReplacementCharacter. For details, please see

https://www.w3.org/TR/xml/#NT-Char

 nameOfEncoding