_strninc, _wcsninc, _mbsninc, _mbsninc_l

Artigo
06/09/2015

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

Importante

_mbsninc e _mbsninc_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.

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 ser usada.

Valor de retorno

Cada uma dessas rotinas retorna um ponteiro para str após str ter sido incrementado por caracteres count ou NULL se o ponteiro fornecido for NULL. Se count for maior ou igual ao número de caracteres em str, o resultado será indefinido.

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 em uso no momento.

Mapeamentos da 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 cadeias de caracteres largos e de caracteres de byte único de _mbsninc. _wcsninc e _strninc 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.

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