EncodeStringFromVariant

Text, Miscellaneous functions

Description

This function is used to encode a string in UTF-16LE format from an array of numbers stored as a Variant type.

Syntax

ActiveX

Function PDFlib::EncodeStringFromVariant(NumberList As Variant, Encoding As String, UnmatchedAction As Long) As String

Parameters

NumberList

A variant array of numbers. The numbers in the array can be stored in any ordinal variant type (signed or unsigned integers from 8 to 32 bits).

Encoding

A string that defines how numbers in the array should be mapped to character codes:

"Unicode" = Os números representam pontos de código Unicode com valores variando de 0x0000 a 0x10FFFD

"UTF-8" = Os números representam os bytes de pontos de código Unicode codificados usando o esquema de codificação UTF-8 de comprimento variável com valores variando de 0 a 244

"UTF-16" = Os números representam os valores de 16 bits de pontos de código Unicode codificados usando o esquema de codificação UTF-16 de comprimento variável com valores variando de 0 a 65533. Os valores Unicode de U+010000 a U+10FFFD são representados por um par de substitutos composto por uma sequência de dois números

"UTF-16LE" = Os números representam os bytes do esquema de codificação UTF-16 armazenados no formato little-endian com valores variando de 0 a 255. "UTF-16BE" = Os números representam os bytes do esquema de codificação UTF-16 armazenados no formato big-endian com valores variando de 0 a 255. "CP932" = Os números representam bytes individuais ou uma combinação de valores de 8 bits e 16 bits da página de códigos 932 da Microsoft (uma extensão da codificação Shift JIS). Valores de duplo byte podem ser apresentados como um número de 16 bits ou como dois números de 8 bits

For encodings where numbers represent bytes this function will cast signed 8-bit values to unsigned 8-bit values.

UnmatchedAction

Specifies how to handle numbers that are out of range or that map to invalid character codes:

0 = Caracteres não correspondentes são ignorados

1 = Caracteres não correspondentes são substituídos pelo caractere de substituição Unicode U+FFFD