EncodeStringFromVariant

Texto, funções diversas

Descrição

Esta função é utilizada para codificar uma cadeia no formato UTF-16LE a partir de uma matriz de números armazenada como tipo Variant

Sintaxe

ActiveX

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

Parâmetros

NumberList

Uma matriz variável de números. Os números da matriz podem ser armazenados em qualquer tipo variável ordinal (inteiros com ou sem sinal, de 8 a 32 bits)

Encoding

Uma cadeia que define como os números da matriz devem ser mapeados para códigos de carateres:

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

"UTF-8" = Os números representam os bytes de pontos de código Unicode codificados através do esquema de codificação UTF-8 de comprimento variável, com valores entre 0 e 244

"UTF-16" = Os números representam os valores de 16 bits dos pontos de código Unicode codificados através do esquema UTF-16 de comprimento variável, com valores de 0 a 65533. Os valores Unicode de U+010000 a U+10FFFD são representados por um par substituto 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 em formato little-endian, com valores de 0 a 255. "UTF-16BE" = Os números representam os bytes do esquema de codificação UTF-16 armazenados em formato big-endian, com valores de 0 a 255. "CP932" = Os números representam bytes individuais ou uma combinação de valores de 8 e 16 bits da página de códigos Microsoft 932 (uma extensão da codificação Shift JIS). Os valores de dois bytes podem ser apresentados como um número de 16 bits ou dois números de 8 bits

Nas codificações em que os números representam bytes, esta função converte valores de 8 bits com sinal em valores de 8 bits sem sinal

UnmatchedAction

Especifica como processar números que estão fora do intervalo ou que são mapeados para códigos de carateres inválidos:

0 = Os carateres sem correspondência são ignorados

1 = Os carateres sem correspondência são substituídos pelo caráter de substituição Unicode U+FFFD