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.