_strnextc, _wcsnextc, _mbsnextc, _mbsnextc_l

Busca el siguiente carácter de una cadena.

Importante

_mbsnextc y _mbsnextc_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

unsigned int _strnextc(
   const char *str
);
unsigned int _wcsnextc(
   const wchar_t *str
);
unsigned int _mbsnextc(
   const unsigned char *str
);
unsigned int _mbsnextc_l(
   const unsigned char *str,
   _locale_t locale
);

Parámetros

str
Cadena de origen.

locale
Configuración regional que se va a usar.

Valor devuelto

Cada una de estas funciones devuelve el valor entero del carácter siguiente en str.

Comentarios

La función _mbsnextc devuelve el valor entero del siguiente carácter multibyte de str, sin avanzar el puntero de cadena. _mbsnextc reconoce las secuencias de caracteres multibyte de acuerdo con la página de códigos multibyte actualmente en uso.

Si str es NULL, se invoca el controlador de parámetros no válidos, como se describe en Validación de parámetros. Si la ejecución puede continuar, errno se establece en EINVAL y la función devuelve 0.

Nota de seguridad Esta API crea la posible amenaza de un problema de saturación del búfer. Los problemas de saturación del búfer son un método frecuente de ataque del sistema, que produce una elevación de privilegios no justificada. Para obtener más información, consulte Evitar saturaciones de búfer.

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
_tcsnextc	_strnextc	_mbsnextc	_wcsnextc

_strnextc y _wcsnextc son versiones de cadena de caracteres de un solo byte y cadenas de caracteres anchos de _mbsnextc. _wcsnextc devuelve el valor entero del siguiente carácter ancho de str; _strnextc devuelve el valor entero del siguiente carácter de un solo byte de str. _strnextc y _wcsnextc 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.

_mbsnextc_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
_mbsnextc	<mbstring.h>
_mbsnextc_l	<mbstring.h>
_strnextc	<tchar.h>
_wcsnextc	<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
_strninc, _wcsninc, _mbsninc, _mbsninc_l