_mbsninc, _mbsninc_l, _strninc, _wcsninc

Artigo
08/25/2010

Avança um ponteiro de seqüência de caracteres por n caracteres.

unsigned char *_mbsninc(
   const unsigned char *str,
   size_t count 
);
unsigned char *_mbsninc(
   const unsigned char *str,
   size_t count,
   _locale_t locale
);
char *_strninc(
   const char *str,
   size_t count 
);
wchar_t *_wcsninc(
   const wchar_t *str,
   size_t count 
);

Parâmetros

str
Seqüência de caracteres de fonte.
count
Número de caracteres para incrementar um ponteiro de seqüência de caracteres.
locale
Localidade usar.

Valor de retorno

Cada uma dessas rotinas retorna um ponteiro para str Depois de str foi incrementado pelas count caracteres ou NULL Se o ponteiro fornecido for NULL. If count é maior que ou igual ao número de caracteres em str, o resultado é indefinido.

Comentários

The _mbsninc incrementos de função str Por count caracteres de multibyte. _mbsninc reconhece as seqüências de caractere multibyte acordo com o página de código multibyte atualmente em uso.

Mapeamentos de rotina de texto genérica

Rotina tchar.h	_UNICODE e _MBCS não definido	_MBCS definido	_UNICODE definido
_tcsninc	_strninc	_mbsninc	_wcsninc

_strninc e _wcsninc é byte–caractere única seqüência de caractere e caractere largos versões de seqüência de caractere do _mbsninc. _wcsninc e _strninc são fornecidos somente para este mapeamento e não deve ser usada caso contrário. Para obter mais informações, consulte Usando mapeamentos de texto genérico and Mapeamentos de texto genérica.

_mbsninc_l é idêntica, exceto pelo fato de que ele utiliza o parâmetro de localidade passado em vez disso.For more information, see Localidade.