_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.

Valor retornado

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âmetro inválido será chamado, 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, confira Como evitar sobrecargas de buffer.

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
_tcsnextc	_strnextc	_mbsnextc	_wcsnextc

_strnextc e _wcsnextc são versões de cadeia de caracteres de byte único e cadeia de caracteres largos de _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 _wcsnextc são fornecidos apenas para esse mapeamento e 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