SetUTF16Table Method (CLIENT)

PLB Web Only, 9.7C

The SetUTF16Table method specifies a UNICODE translation table that is used by the PWS server when performing UTF8 conversions for data communicated to\from a client browser. The method uses the following format:

Where:

label

Optional. A Program Execution Label.

object

Required. A CLIENT object.

return

Optional. A Numeric Variable that is always zero.

table

Required. A Character String Variable or string literal that contains the Unicode translate character string.

Flags Affected: EOS, OVER, ZERO

Note the following:

1. This UNICODE translation table must be provided in low-byte/high-byte order (i.e., Little Endian byte order). It translates character values greater than 0x7F up to and including character value 0xFF. The first UNICODE translation value at position zero (0) is for the character value of 0x80.

2. The EOS flag is set off.

3. The ZERO flag is set on.

4. The OVER flag is set off.

5. The Unicode translation data specified in the {table} as 16 bit values that must be provided in Little Endian format. The translation character table is layout as follows:

 

Table Position	Translation Character	Unicode Table Value
1-2	0x80	0xLL, 0xHH
3-4	0x81	0xLL, 0xHH
...
127-128	0xFF	0xLL, 0xHH

Example:

.....

. This translation table only contains 5 Unicode

. translation values

.

. Unicode 8-bit character value

.

UnicodeTable INIT 0xD0, 0x05: //0x80 char value

                    0xD4, 0x05: //0x81 char value

                    0xE5, 0x05: //0x82 char value

                    0xE6, 0x05: //0x83 char value

                    0xD7, 0x05 //0x84 char value

                                  //...

                                  //0xFF char value

.

Client CLIENT

....

. Define a Unicode translation table and set the PWS

. to use the Unicode translation table when performing

. UTF8 data communications conversions.

.

              Client.SetUTF16Table USING UnicodeTable

              Client.SetUTF8Convert USING 2

              ...

See Also: CLIENT, Client Methods, Method Syntax