_strninc, _wcsninc, _mbsninc, _mbsninc_l

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

Importante

_mbsninc e _mbsninc_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 *_strninc(
   const char *str,
   size_t count
);
wchar_t *_wcsninc(
   const wchar_t *str,
   size_t count
);
unsigned char *_mbsninc(
   const unsigned char *str,
   size_t count
);
unsigned char *_mbsninc(
   const unsigned char *str,
   size_t count,
   _locale_t locale
);

Parâmetros

str
Cadeia de caracteres de origem.

count
Número de caracteres para incrementar um ponteiro de cadeia de caracteres.

locale
Localidade a usar.

Valor retornado

Todas essas rotinas retornam um ponteiro para str após str ter sido incrementado por count caracteres ou NULL se o ponteiro fornecido for NULL. Se count for maior ou igual ao número de caracteres em str, a cadeia de caracteres inteira será indefinida.

Comentários

A função _mbsninc incrementa str por count caracteres multibyte. _mbsninc reconhece sequências de caracteres multibyte de acordo com a página de código multibyte atualmente em uso.

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
_tcsninc	_strninc	_mbsninc	_wcsninc

_strninc e _wcsninc são versões de cadeia de caracteres de byte único e cadeia de caracteres largos de _mbsninc. _wcsninc e _strninc 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.

_mbsninc_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
_mbsninc	<mbstring.h>
_mbsninc_l	<mbstring.h>
_strninc	<tchar.h>
_wcsninc	<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
_strnextc, _wcsnextc, _mbsnextc, _mbsnextc_l