_strspnp, _wcsspnp, _mbsspnp, _mbsspnp_l

Artículo
04/10/2013

Devuelve un puntero al primer carácter de una cadena especificada que no está en otra cadena determinada.

Importante
_mbsspnp y _mbsspnp_l no se pueden utilizar en las aplicaciones que se ejecutan en tiempo de ejecución de Windows.Para obtener más información, vea Funciones CRT no compatibles con /ZW.

char *_strspnp(
   const char *str,
   const char *charset
);
wchar_t *_wcsspnp(
   const unsigned wchar_t *str,
   const unsigned wchar_t *charset
);
unsigned char *_mbsspnp(
   const unsigned char *str,
   const unsigned char *charset
);
unsigned char *_mbsspnp_l(
   const unsigned char *str,
   const unsigned char *charset,
   _locale_t locale
);

Parámetros

str
Cadena terminada en null para buscar.
charset
Juego de caracteres terminada en null.
locale
Configuración regional a utilizar.

Valor devuelto

_strspnp, _wcsspnp, y retorno de _mbsspnp un puntero al primer carácter de str que no pertenece al conjunto de caracteres en charset*.* Cada una de estas funciones devuelve NULL si str consta de caracteres de charset*.* Para cada una de estas rutinas, no se reserva ningún valor devuelto para indicar un error.

Comentarios

La función de _mbsspnp devuelve un puntero al carácter multibyte que es el primer carácter de str que no pertenece al conjunto de caracteres en charset._mbsspnp reconoce secuencias de multibyte- carácter como página de códigos multibyte actualmente en uso.La búsqueda no incluye finalizar los caracteres null.

Si str o charset es un puntero NULL, esta función invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros.Si la ejecución puede continuar, la función devuelve NULL y establece errno a EINVAL.

Asignaciones de la rutina de Genérico- texto

Rutina de Tchar.h	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_tcsspnp	_strspnp	_mbsspnp	_wcsspnp

_strspnp y _wcsspnp son versiones de caracteres y de caracteres anchos de solo- byte de _mbsspnp._strspnp y _wcsspnp se comportan de forma idéntica a _mbsspnp de otra manera; se proporcionan solo para esta asignación y no deben ser utilizados por cualquier otro motivo.Para obtener más información, vea Mediante asignaciones de Genérico- texto y Asignaciones de Genérico- texto.

_mbsspnp_l es idéntico pero utiliza el parámetro locale pasado en su lugar.Para obtener más información, vea Configuración regional.

Requisitos

Rutina	Encabezado necesario
_mbsspnp	<mbstring.h>
_strspnp	<tchar.h>
_wcsspnp	<tchar.h>

Para obtener más información de compatibilidad, vea Compatibilidad en la Introducción.

Ejemplo

// crt_mbsspnp.c
#include <mbstring.h>
#include <stdio.h>

int main( void ) {
   const unsigned char string1[] = "cabbage";
   const unsigned char string2[] = "c";
   unsigned char *ptr = 0;
   ptr = _mbsspnp( string1, string2 );
   printf( "%s\n", ptr);
}