Namespaces
Variants

wcspbrk

From cppreference.net
< c ‎ | string ‎ | wide
C
Strings library
Null-terminated wide strings
Definido en el encabezado <wchar.h>
wchar_t * wcspbrk ( const wchar_t * dest, const wchar_t * str ) ;
(1) (desde C95)
/*QWchar_t*/ * wcspbrk ( /*QWchar_t*/ * dest, const wchar_t * str ) ;
(2) (desde C23)
1) Encuentra el primer carácter en la cadena ancha apuntada por dest , que también está en la cadena ancha apuntada por str .
2) Función genérica de tipos equivalente a (1) . Sea T un tipo de objeto de carácter ancho no calificado.
  • Si dest es de tipo const T * , el tipo de retorno es const wchar_t * .
  • De lo contrario, si dest es de tipo T * , el tipo de retorno es wchar_t * .
  • De lo contrario, el comportamiento es indefinido.
Si se suprime la definición de macro de cada una de estas funciones genéricas para acceder a una función real (por ejemplo, si se usa ( wcspbrk ) o un puntero a función), la declaración de función real (1) se hace visible.

Contenidos

Parámetros

dest - puntero a la cadena ancha terminada en nulo que se va a analizar
src - puntero a la cadena ancha terminada en nulo que contiene los caracteres a buscar

Valor de retorno

Puntero al primer carácter en dest , que también está en str , o un puntero nulo si no existe tal carácter.

Notas

El nombre significa "puntero de cadena de caracteres anchos de ruptura", porque devuelve un puntero al primero de los caracteres separadores ("ruptura").

Ejemplo

Ejecutar este código 
#include <stdio.h>
#include <wchar.h>
int main(void)
{
    const wchar_t* str = L"Hello world, friend of mine!";
    const wchar_t* sep = L" ,!";
    unsigned int cnt = 0;
    do {
       str = wcspbrk(str, sep); // encontrar separador
       if (str) str += wcsspn(str, sep); // saltar separador
       ++cnt; // incrementar contador de palabras
    } while (str && *str);
    wprintf(L"There are %u words.\n", cnt);
}

Salida: 

There are 5 words.

Referencias

  • Estándar C11 (ISO/IEC 9899:2011):
  • 7.29.4.5.3 La función wcspbrk (p: 436)
  • Estándar C99 (ISO/IEC 9899:1999):
  • 7.24.4.5.3 La función wcspbrk (p: 382)

Véase también

(C95)
devuelve la longitud del segmento inicial máximo que consiste
únicamente de caracteres anchos no encontrados en otra cadena ancha
(función)
(C95)
encuentra la primera ocurrencia de un carácter ancho en una cadena ancha
(función)
encuentra la primera ubicación de cualquier carácter de una cadena en otra cadena
(función)
Documentación de C++ para wcspbrk