Função IsDBCSLeadByteEx (winnls.h)

  • Artigo

Determina se um caractere especificado é potencialmente um byte de cliente potencial. Um byte principal é o primeiro byte de um caractere de dois bytes em um DBCS ( conjunto de caracteres de byte duplo ) para a página de código.

Sintaxe

BOOL IsDBCSLeadByteEx(
  [in] UINT CodePage,
  [in] BYTE TestChar
);

Parâmetros

[in] CodePage

Identificador da página de código usada para marcar intervalos de bytes potenciais. Esse parâmetro pode ser um dos identificadores de página de código definidos em Constantes Unicode e Conjunto de Caracteres ou um dos valores predefinidos a seguir. Essa função valida os valores de bytes potenciais somente nas páginas de código 932, 936, 949, 950 e 1361.

Valor Significado
CP_ACP
 Use a página de código ANSI do Windows padrão do sistema.
CP_MACCP
 Use a página de código padrão do Macintosh do sistema.
CP_OEMCP
 Use a página de código OEM padrão do sistema.
CP_THREAD_ACP
 Use a página de código ANSI do Windows para o thread atual.

[in] TestChar

O caractere a ser testado.

Retornar valor

Retorna um valor diferente de zero se o byte for um byte de cliente potencial. A função retornará 0 se o byte não for um byte de chumbo ou se o caractere for um caractere de byte único. Para obter informações de erro estendidas, o aplicativo pode chamar GetLastError.

Comentários

Nota Essa função não valida a presença ou a validade de um byte de trilha. Portanto, MultiByteToWideChar pode não reconhecer uma sequência que o aplicativo usando IsDBCSLeadByte relata como um byte de cliente potencial. O aplicativo pode facilmente se tornar não sincronizado com os resultados de MultiByteToWideChar, potencialmente levando a erros inesperados ou incompatibilidades de tamanho de buffer.
 
Em geral, em vez de tentar manipulação de baixo nível de dados de página de código, os aplicativos devem usar MultiByteToWideChar para converter os dados em UTF-16 e trabalhar com eles nessa codificação.

Os valores de bytes de lead são específicos para cada DBCS distinto. Alguns valores de byte podem aparecer em uma única página de código como o byte de lead e trail de um caractere DBCS. Portanto, IsDBCSLeadByteEx só pode indicar um valor de byte potencial de lead.

Para dar sentido a uma cadeia de caracteres DBCS, um aplicativo normalmente começa no início da cadeia de caracteres e examina para frente, acompanhando quando encontra um byte de chumbo e tratando o próximo byte como a parte à direita do mesmo caractere. Para fazer backup, o aplicativo deve usar CharPrevExA em vez de tentar desenvolver seu próprio algoritmo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho winnls.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

MultiByteToWideChar

Funções unicode e conjunto de caracteres

Conjuntos de caracteres e Unicode

WideCharToMultiByte