_mbsninc, _mbsninc_l, _strninc, _wcsninc

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

_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.

Requisitos

Para obter mais informações de compatibilidade, consulte Compatibilidade na introdução.

Equivalente do NET Framework

Não aplicável. Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.

Consulte também

Referência

Manipulação de seqüência de caracteres (CRT)

Localidade

Interpretação de seqüências de caractere multibyte

_mbsdec, _mbsdec_l, _strdec, _wcsdec

_mbsinc, _mbsinc_l, _strinc, _wcsinc

_mbsnextc, _mbsnextc_l, _strnextc, _wcsnextc