_strnextc, _wcsnextc, _mbsnextc, _mbsnextc_l

Artigo
02/25/2013

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

Importante
_mbsnextc e _mbsnextc_l não podem ser usados em aplicativos que executam em Tempo de Execução do Windows.Para obter mais informações, consulte Funções de CRT não suportadas com /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
A localidade usar.

Valor de retorno

Cada uma dessas funções retorna o valor inteiro do próximo caractere em str*.*

Comentários

A função de _mbsnextc retorna o valor inteiro do próximo caractere de multibyte em str, sem avançar o ponteiro de cadeia de caracteres._mbsnextc reconhece sequências de multibyte- caractere de acordo com página de código de multibyte atualmente em uso.

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

Nota de segurança Esta API provoca uma ameaça potencial causada por um problema de estouro de buffer.Problemas de estouro de buffer são um método frequente de ataque do sistema, resultando em uma despropositado elevação de privilégio.Para obter mais informações, consulte Evitando estouros de buffer.

Mapeamentos da rotina de Genérico- texto

Rotina de Tchar.h	_UNICODE e não definidos _MBCS	_MBCS definido	_UNICODE definido
_tcsnextc	_strnextc	_mbsnextc	_wcsnextc

_strnextc e _wcsnextc são versões de cadeia de caracteres de único-byte- caracteres e a cadeia de caracteres de largo- caractere de _mbsnextc._wcsnextc retorna o valor inteiro de caracteres a seguir em string; _strnextc retorna o valor inteiro do próximo caractere de único byte 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 Genérico- texto e Mapeamentos de Genérico- texto.

_mbsnextc_lsão idênticos exceto que usa o parâmetro de localidade passado em vez disso.Para obter mais informações, consulte Localidade.