strspn, wcsspn, _mbsspn, _mbsspn_l

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

Nota importanteImportante

_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 );
}
  La parte “col” que sólo contiene, b, o c es de 5 bytes de longitud

Equivalente en .NET Framework

System::String::Substring

Vea también

Referencia

Manipulación de cadenas (CRT)

Configuración regional

Interpretación de secuencias de Multibyte- Carácter

_strspnp, _wcsspnp, _mbsspnp, _mbsspnp_l

strcspn, wcscspn, _mbscspn, _mbscspn_l

strncat, _strncat_l, wcsncat, wcsncat_l, _mbsncat _mbsncat_l

strncmp, wcsncmp, _mbsncmp, _mbsncmp_l

strncpy, _strncpy_l, wcsncpy, _wcsncpy_l, _mbsncpy, _mbsncpy_l

_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

strrchr, wcsrchr, _mbsrchr, _mbsrchr_l