strpbrk, wcspbrk, _mbspbrk, _mbspbrk_l
Cadenas de análisis por caracteres de juegos de caracteres especificados.
Importante |
---|
_mbspbrk y _mbspbrk_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 *strpbrk(
const char *str,
const char *strCharSet
); // C only
char *strpbrk(
char *str,
const char *strCharSet
); // C++ only
const char *strpbrk(
const char *str,
const char *strCharSet
); // C++ only
wchar_t *wcspbrk(
const wchar_t *str,
const wchar_t *strCharSet
); // C only
wchar_t *wcspbrk(
wchar_t *str,
const wchar_t *strCharSet
); // C++ only
const wchar_t *wcspbrk(
const wchar_t *str,
const wchar_t *strCharSet
); // C++ only
unsigned char *_mbspbrk(
const unsigned char *str,
const unsigned char *strCharSet
); // C only
unsigned char *_mbspbrk(
unsigned char *str,
const unsigned char *strCharSet
); // C++ only
const unsigned char *_mbspbrk(
const unsigned char *str,
const unsigned char *strCharSet
); // C++ only
unsigned char *_mbspbrk_l(
const unsigned char *str,
const unsigned char *strCharSet,
_locale_t locale
); // C only
unsigned char *_mbspbrk_l(
unsigned char *str,
const unsigned char *strCharSet,
_locale_t locale
); // C++ only
const unsigned char *_mbspbrk_l(
const unsigned char *str,
const unsigned char* strCharSet,
_locale_t locale
); // C++ only
Parámetros
str
Cadena terminada en null, buscada.strCharSet
Juego de caracteres terminada en null.locale
Configuración regional a utilizar.
Valor devuelto
Devuelve un puntero a la primera aparición de cualquier carácter de strCharSet en str, o un puntero de NULL si los dos argumentos de cadena no tienen ningún carácter en común.
Comentarios
La función de strpbrk devuelve un puntero a la primera aparición de un carácter de str que pertenece al conjunto de caracteres en strCharSet.La búsqueda no incluye el carácter null de terminación.
wcspbrk y _mbspbrk son versiones de caracteres anchos y de multibyte- carácter de strpbrk.Los argumentos y el valor devuelto de wcspbrk son cadenas de caracteres; las de _mbspbrk son cadenas de multibyte- carácter.
_mbspbrk 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, _mbspbrk devuelve NULL y establece errno a EINVAL.strpbrk y wcspbrk no validan sus parámetros.Estas tres funciones se comportan exactamente igual de otra manera.
_mbspbrk es similar a _mbscspn salvo que _mbspbrk devuelve un puntero en lugar de un valor de size_t escrito.
En C, estas funciones toman un puntero de const para el primer argumento.En C++, dos sobrecargas están disponibles.La sobrecarga que toma un puntero a const devuelve un puntero a const; la versión que contiene un puntero const no devuelve un puntero a const no.Se define el _CONST_CORRECT_OVERLOADS macro si const y las versiones no de const de estas funciones están disponibles.Si requiere el comportamiento no de const para ambas sobrecargas de C++, defina el _CONST_RETURN de símbolos.
El valor de salida se ve afectado por el valor de la categoría de LC_CTYPE de configuración regional; para obtener más información, vea setlocale.Las versiones de estas funciones sin el sufijo de _l utilizan la configuración regional actual para este comportamiento configuración regional-dependiente; la versión con el sufijo de _l es idéntica pero utiliza 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 |
---|---|---|---|
_tcspbrk |
strpbrk |
_mbspbrk |
wcspbrk |
no disponible |
no disponible |
_mbspbrk_l |
no disponible |
Requisitos
Rutina |
Encabezado necesario |
---|---|
strpbrk |
<string.h> |
wcspbrk |
<string.h> o <wchar.h> |
_mbspbrk, _mbspbrk_l |
<mbstring.h> |
Para obtener más información sobre la compatibilidad, vea Compatibilidad.
Ejemplo
// crt_strpbrk.c
#include <string.h>
#include <stdio.h>
int main( void )
{
char string[100] = "The 3 men and 2 boys ate 5 pigs\n";
char *result = NULL;
// Return pointer to first digit in "string".
printf( "1: %s\n", string );
result = strpbrk( string, "0123456789" );
printf( "2: %s\n", result++ );
result = strpbrk( result, "0123456789" );
printf( "3: %s\n", result++ );
result = strpbrk( result, "0123456789" );
printf( "4: %s\n", result );
}
Equivalente en .NET Framework
Vea también
Referencia
Interpretación de secuencias de Multibyte- Carácter
strcspn, wcscspn, _mbscspn, _mbscspn_l