Função IsDBCSLeadByte (winnls.h)

  • Artigo

Determina se um caractere especificado é um byte de cliente potencial para a página de código ANSI padrão do sistema do Windows (CP_ACP). 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.

Nota Para usar uma página de código diferente, seu aplicativo deve usar a função IsDBCSLeadByteEx .
 

Sintaxe

BOOL IsDBCSLeadByte(
  [in] BYTE TestChar
);

Parâmetros

[in] TestChar

O caractere a ser testado.

Retornar valor

Retornará um valor diferente de zero se o caractere de teste for potencialmente um byte de lead. A função retornará 0 se o caractere de teste não for um byte de chumbo ou se 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.

Para dar sentido a uma cadeia de caracteres DBCS, um aplicativo normalmente começa no início de uma cadeia de caracteres e examina para frente, acompanhando quando encontra um byte de cliente potencial e tratando o próximo byte como a parte à direita do mesmo caractere. Se o aplicativo precisar fazer backup, ele deverá usar CharPrev 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

IsDBCSLeadByteEx

MultiByteToWideChar

Funções unicode e conjunto de caracteres

Conjuntos de caracteres e Unicode