_strinc, _wcsinc, _mbsinc, _mbsinc_l

Avança um ponteiro de cadeia de caracteres em um caractere.

Importante

_mbsinc e _mbsinc_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

char *_strinc(
   const char *current,
   _locale_t locale
);
wchar_t *_wcsinc(
   const wchar_t *current,
   _locale_t locale
);
unsigned char *_mbsinc(
   const unsigned char *current
);
unsigned char *_mbsinc_l(
   const unsigned char *current,
   _locale_t locale
);

Parâmetros

current
Ponteiro de caractere.

locale
Localidade a usar.

Valor retornado

Todas essas rotinas retornam um ponteiro para o caractere logo depois de current.

Comentários

A função _mbsinc retorna um ponteiro para o primeiro byte do caractere multibyte logo depois de current. _mbsinc reconhece sequências de caractere multibyte de acordo com a página de código multibyte atualmente em uso; _mbsinc_l é idêntico, exceto por usar o parâmetro de localidade passado. Para obter mais informações, consulte Localidade.

A função de texto genérica _tcsinc, definida em Tchar.h, é mapeada para _mbsinc caso _MBCS tenha sido definido ou para _wcsinc caso _UNICODE tenha sido definido. Do contrário, _tcsinc é mapeado para _strinc. _strinc e _wcsinc são versões de caractere de byte único e de caractere largo de _mbsinc. _strinc e _wcsinc 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.

Se current for NULL, o manipulador de parâmetro inválido será chamado, conforme descrito em Validação de parâmetro. Se a execução puder continuar, essa função retornará EINVAL e definirá errno como EINVAL.

Importante

Essas funções podem ser vulneráveis a ameaças de estouro de buffer. Os estouros de buffer podem ser usados em ataques de sistema porque podem causar uma elevação de privilégio não garantida. 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.

Requisitos

Rotina	Cabeçalho necessário
_mbsinc	<mbstring.h>
_mbsinc_l	<mbstring.h>
_strinc	<tchar.h>
_wcsinc	<tchar.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Confira também

Manipulação de cadeia de caracteres
_strdec, _wcsdec, _mbsdec, _mbsdec_l
_strnextc, _wcsnextc, _mbsnextc, _mbsnextc_l
_strninc, _wcsninc, _mbsninc, _mbsninc_l