_strninc, _wcsninc, _mbsninc, _mbsninc_l

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 en aplicaciones de la Plataforma universal de Windows.

Sintaxis

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.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Asignaciones de rutinas 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 caracteres de un solo byte y cadenas de caracteres anchos de _mbsninc. _wcsninc y _strninc solo se proporcionan para esta asignación y no se deben usar de otro modo. Para obtener más información, consulte Uso de 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 Locale.

Requisitos

Routine	Encabezado necesario
_mbsninc	<mbstring.h>
_mbsninc_l	<mbstring.h>
_strninc	<tchar.h>
_wcsninc	<tchar.h>

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Consulte también

Manipulación de cadenas
Configuración regional
Interpretación de secuencias de caracteres multibyte
_strdec, _wcsdec, _mbsdec, _mbsdec_l
_strinc, _wcsinc, _mbsinc, _mbsinc_l
_strnextc, _wcsnextc, _mbsnextc, _mbsnextc_l