_strnextc, _wcsnextc, _mbsnextc, _mbsnextc_l

Artigo
06/09/2015

Localiza o próximo caractere em uma cadeia de caracteres.

Importante

_mbsnextc e _mbsnextc_l não podem ser usados em aplicativos executados no Tempo de Execução do Windows.Para obter mais informações, consulte Funções CRT sem suporte pelo /ZW.

unsigned int _strnextc(
   const char *str
);
unsigned int _wscnextc(
   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 ser usada.

Valor de retorno

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 de cadeia de caracteres. _mbsnextc reconhece sequências de caracteres multibyte de acordo com a página de código multibyte em uso no momento.

Se str é NULL, o parâmetro de manipulador inválido é invocado, como descrito em Validação do parâmetro. Se a execução puder continuar, errno será definido como EINVAL e a função retornará 0.

Observação de segurança Esta API resulta em uma potencial ameaça causada por um problema de estouro de buffer. Problemas de saturação de buffer é um método frequente de ataque do sistema, resultando em elevação injustificável de privilégio. Para obter mais informações, consulte Evitando saturações de buffer.

Mapeamentos da 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 cadeias de caracteres largos e de caracteres de byte único de _mbsnextc. _wcsnextc retorna o valor inteiro do próximo caractere lardo em string; _strnextc retorna o valor inteiro do próximo caractere de byte único em string. _strnextc e _wcsnextc são fornecidos apenas para esse mapeamento e não devem ser usados de outra maneira. Para obter mais informações, consulte Usando mapeamentos de texto genérico e Mapeamentos de texto genérico.

_mbsnextc_lé idêntico, exceto que usa o parâmetro de localidade passado no lugar. Para obter mais informações, consulte Localidade.