strspn, wcsspn, _mbsspn, _mbsspn_l

Artículo
04/10/2013

Devuelve el índice del primer carácter de una cadena que no pertenece a un conjunto de caracteres.

Importante
_mbsspn y _mbsspn_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.

size_t strspn(
   const char *str,
   const char *strCharSet 
);
size_t wcsspn(
   const wchar_t *str,
   const wchar_t *strCharSet 
);
size_t _mbsspn(
   const unsigned char *str,
   const unsigned char *strCharSet 
);
size_t _mbsspn_l(
   const unsigned char *str,
   const unsigned char *strCharSet,
   _locale_t locale
);

Parámetros

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

Valor devuelto

Devuelve un valor entero que especifica la longitud de la subcadena en str que consta de caracteres en strCharSet*.* Si str comienza con un carácter no en strCharSet*, la* función devuelve 0.

Comentarios

La función de strspn devuelve el índice del primer carácter de str que no pertenece al conjunto de caracteres en strCharSet.La búsqueda no incluye finalizar los caracteres null.

wcsspn y _mbsspn son versiones de caracteres anchos y de multibyte- carácter de strspn**.** Los argumentos de wcsspn son cadenas de caracteres; las de _mbsspn son cadenas de multibyte- carácter._mbsspn valida sus parámetros.Si str o strCharSet es NULL, se 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, _mbspn establece errno a EINVAL y devuelve 0.strspn y wcsspn no validan sus parámetros.Estas tres funciones se comportan exactamente igual de otra manera.

El valor de salida se ve afectado por el valor de la categoría de LC_CTYPE de configuración regional; vea setlocale para obtener más información.Las versiones de estas funciones sin el sufijo de _l utilizan la configuración regional actual para este comportamiento configuración regional-dependiente; las versiones con el sufijo de _l son idénticas salvo que utilizan el parámetro locale pasado en su lugar.Para obtener más información, vea Configuración regional.

Asignaciones de la rutina de Genérico- texto

Rutina de TCHAR.H	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_tcsspn	strspn	_mbsspn	wcsspn
no disponible	no disponible	_mbsspn_l	no disponible

Requisitos

Rutina	Encabezado necesario
strspn	<string.h>
wcsspn	<string.h> o <wchar.h>
_mbsspn, _mbsspn_l	<mbstring.h>

Para obtener información adicional de compatibilidad, vea Compatibilidad en la Introducción.

Ejemplo

// crt_strspn.c
// This program uses strspn to determine
// the length of the segment in the string "cabbage"
// consisting of a's, b's, and c's. In other words,
// it finds the first non-abc letter.
//

#include <string.h>
#include <stdio.h>

int main( void )
{
   char string[] = "cabbage";
   int  result;
   result = strspn( string, "abc" );
   printf( "The portion of '%s' containing only a, b, or c "
           "is %d bytes long\n", string, result );
}