strcspn, wcscspn, _mbscspn, _mbscspn_l
Devuelve el índice de la primera aparición de un carácter de una cadena que pertenece a un conjunto de caracteres.
Importante |
---|
_mbschr y _mbschr_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 strcspn(
const char *str,
const char *strCharSet
);
size_t wcscspn(
const wchar_t *str,
const wchar_t *strCharSet
);
size_t _mbscspn(
const unsigned char *str,
const unsigned char *strCharSet
);
size_t _mbscspn_l(
const unsigned char *str,
const unsigned char *strCharSet,
_locale_t locale
);
Parámetros
str
Cadena buscada terminada en null.strCharSet
Juego de caracteres terminada en null.locale
Configuración regional a utilizar.
Valor devuelto
Estas funciones devuelven el índice del primer carácter de str que está en strCharSet.Si ninguno de los caracteres de str están en strCharSet, el valor devuelto es la longitud de str.
No se reserva ningún valor devuelto para indicar un error.
Comentarios
wcscspn y _mbscspn son versiones de caracteres anchos y de multibyte- carácter de strcspn.Los argumentos de wcscspn son cadenas de caracteres; las de _mbscspn son cadenas de multibyte- carácter.
_mbscspn valida sus parámetros.Si str o strCharSet es un puntero 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, la función devuelve 0 y establece errno a EINVAL.strcspn y wcscspn 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 |
---|---|---|---|
_tcscspn |
strcspn |
_mbscspn |
wcscspn |
n/a |
n/a |
_mbscspn_l |
n/a |
Requisitos
Rutina |
Encabezado necesario |
---|---|
strcspn |
<string.h> |
wcscspn |
<string.h> o <wchar.h> |
_mbscspn, _mbscspn_l |
<mbstring.h> |
Para obtener información adicional de compatibilidad, vea Compatibilidad en la Introducción.
Ejemplo
// crt_strcspn.c
#include <string.h>
#include <stdio.h>
void test( const char * str, const char * strCharSet )
{
int pos = strcspn( str, strCharSet );
printf( "strcspn( \"%s\", \"%s\" ) = %d\n", str, strCharSet, pos );
}
int main( void )
{
test( "xyzbxz", "abc" );
test( "xyzbxz", "xyz" );
test( "xyzbxz", "no match" );
test( "xyzbxz", "" );
test( "", "abc" );
test( "", "" );
}
Equivalente en .NET Framework
Vea también
Referencia
Interpretación de secuencias de Multibyte- Carácter
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