_strninc, _wcsninc, _mbsninc, _mbsninc_l

Artículo
06/09/2015

Hace avanzar un puntero de cadena en n caracteres.

Importante

_mbsninc y _mbsninc_l no se pueden usar en aplicaciones que se ejecutan en Windows en tiempo de ejecución.Para obtener más información, vea Funciones de CRT no admitidas con /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
Cadena de origen.
count
Número de caracteres que va a avanzar un puntero de cadena.
locale
Configuración regional que se va a usar.

Valor devuelto

Cada una de estas rutinas devuelve un puntero a str después de que str se ha incrementado en count o NULL si el puntero proporcionado es NULL. Si count es mayor o igual que el número de caracteres de str, el resultado es indefinido.

Comentarios

La función _mbsninc aumenta str en el número de caracteres multibyte de count. _mbsninc reconoce las secuencias de caracteres multibyte de acuerdo con la página de códigos multibyte actualmente en uso.

Asignaciones de rutina de texto genérico

Rutina Tchar.h	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_tcsninc	_strninc	_mbsninc	_wcsninc

_strninc y _wcsninc son versiones de cadena de carácter de un solo byte y de cadena de caracteres anchos de _mbsninc. _wcsninc y _strninc se proporcionan solo para esta asignación y no deben usarse de otra manera. Para obtener más información, vea Usar asignaciones de texto genérico y Asignaciones de texto genérico.

_mbsninc_l es exactamente igual, salvo que usa el parámetro de configuración regional que se pasa. Para obtener más información, vea Configuración regional.