_strninc, _wcsninc, _mbsninc, _mbsninc_l

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

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

_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

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