_strnextc
, _wcsnextc
, _mbsnextc
, _mbsnextc_l
Localiza o próximo caractere em uma cadeia de caracteres.
Importante
_mbsnextc
e _mbsnextc_l
não podem ser usados 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
unsigned int _strnextc(
const char *str
);
unsigned int _wcsnextc(
const wchar_t *str
);
unsigned int _mbsnextc(
const unsigned char *str
);
unsigned int _mbsnextc_l(
const unsigned char *str,
_locale_t locale
);
Parâmetros
str
Cadeia de caracteres de origem.
locale
Localidade a usar.
Retornar valor
Cada uma dessas funções retorna o valor inteiro do próximo caractere em str
.
Comentários
A função _mbsnextc
retorna o valor inteiro do próximo caractere multibyte em str
, sem avançar o ponteiro da cadeia de caracteres. _mbsnextc
reconhece sequências de caracteres multibyte de acordo com a página de código multibyte atualmente em uso.
Se str
for NULL
, o manipulador de parâmetros inválido será invocado, conforme descrito em Validação de parâmetro. Se a execução tiver permissão para continuar, errno
será definido como EINVAL
e a função retornará 0.
Observação de segurança Essa API causa uma ameaça em potencial em relação ao problema de estouro de buffer. Os problemas de estouro de buffer são um método frequente de ataque ao sistema, resultando em uma elevação de privilégio sem garantia. Para obter mais informações, consulte Evitando saturações de buffer.
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 |
---|---|---|---|
_tcsnextc |
_strnextc |
_mbsnextc |
_wcsnextc |
_strnextc
e são versões de cadeia de caracteres de byte único e _wcsnextc
cadeia de caracteres largos do _mbsnextc
. _wcsnextc
retorna o valor inteiro do próximo caractere largo em str
; _strnextc
retorna o valor inteiro do próximo caractere de byte único em str
. _strnextc
e são fornecidos apenas para esse mapeamento e _wcsnextc
não devem ser usados de outra forma. Para obter mais informações, consulte Usando mapeamentos de texto genérico e mapeamentos de texto genérico.
_mbsnextc_l
é idêntico, exceto que ele usa o parâmetro de localidade passado. Para obter mais informações, consulte Localidade.
Requisitos
Rotina | Cabeçalho necessário |
---|---|
_mbsnextc |
<mbstring.h> |
_mbsnextc_l |
<mbstring.h> |
_strnextc |
<tchar.h> |
_wcsnextc |
<tchar.h> |
Para obter informações sobre compatibilidade, consulte Compatibilidade.
Confira também
Manipulação de cadeia de caracteres
Localidade
Interpretação de sequências de caracteres multibyte
_strdec
, _wcsdec
, _mbsdec
, _mbsdec_l
_strinc
, _wcsinc
, _mbsinc
, _mbsinc_l
_strninc
, _wcsninc
, _mbsninc
, _mbsninc_l
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de