_strninc, _wcsninc, _mbsninc, _mbsninc_l

Artigo
02/25/2013

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

Importante
_mbsninc e _mbsninc_l não podem ser usados em aplicativos executados em Tempo de Execução do Windows.Para obter mais informações, consulte Funções de CRT não suportadas com /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
A localidade usar.

Valor de retorno

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

Comentários

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

Mapeamentos da rotina de Genérico- texto

Rotina de Tchar.h	_UNICODE e não definidos _MBCS	_MBCS definido	_UNICODE definido
_tcsninc	_strninc	_mbsninc	_wcsninc

_strninc e _wcsninc são versões de cadeia de caracteres de único-byte- caractere e da cadeia de caracteres de largo- caractere 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 Genérico- texto e Mapeamentos de Genérico- texto.

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