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.

Retornar valor

isleadbyte Retorna um valor diferente de zero se o argumento satisfizer a 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. isleadbyteproduz um resultado significativo para qualquer argumento inteiro de -1 () a UCHAR_MAX (EOF0xFF), 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, consulte Estado global na 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