Compartilhar via


isleadbyte, _isleadbyte_l

Determina se um caractere é o byte inicial de um caractere multibyte.

Importante

Esta API não pode ser usada em aplicativos executados no Windows Runtime. Para obter mais informações, confira Funções do CRT sem suporte em aplicativos da Plataforma Universal do Windows.

Sintaxe

int isleadbyte( int c );
int _isleadbyte_l( int c );

Parâmetros

c
Inteiro a ser testado.

Valor retornado

isleadbyte Retorna um valor diferente de zero se o argumento atender à condição de teste. Caso contrário, retornará 0. Na localidade "C" e em localidades de SBCS (conjunto de caracteres de um byte), isleadbyte sempre retorna 0.

Comentários

A macro isleadbyte retornará um valor diferente de zero se o argumento for o primeiro byte de um caractere multibyte. isleadbyte produz um resultado significativo para qualquer argumento inteiro de -1 (EOF) a UCHAR_MAX (0xFF), inclusive.

O tipo de argumento esperado de isleadbyte é int; se um caractere com sinal for passado, o compilador poderá convertê-lo em um inteiro pela extensão de sinal, gerando resultados imprevisíveis.

A versão dessa função com o sufixo _l é idêntica, exceto pelo fato de que ele usa a localidade passada em vez da localidade atual para seu comportamento que depende da localidade.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Mapeamentos de rotina de texto genérico

Rotina TCHAR.H _UNICODE e _MBCS não definidos _MBCS definido _UNICODE definido
_istleadbyte Sempre retorna falso _isleadbyte Sempre retorna falso

Requisitos

Rotina Cabeçalho necessário
isleadbyte <ctype.h>
_isleadbyte_l <ctype.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Confira também

Classificação de bytes
Localidade
_ismbb Rotinas