W3cubDocs

/C

wcspbrk

Defined in header <wchar.h>
wchar_t* wcspbrk( const wchar_t* dest, const wchar_t* str );
(since C95)

Finds the first character in wide string pointed to by dest, that is also in wide string pointed to by str.

Parameters

dest - pointer to the null-terminated wide string to be analyzed
src - pointer to the null-terminated wide string that contains the characters to search for

Return value

Pointer to the first character in dest, that is also in str, or a null pointer if no such character exists.

Notes

The name stands for "wide character string pointer break", because it returns a pointer to the first of the separator ("break") characters.

Example

#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); // find separator
       if (str) str += wcsspn(str, sep); // skip separator
       ++cnt; // increment word count
    } while (str && *str);
 
    wprintf(L"There are %u words.\n", cnt);
}

Output:

There are 5 words.

References

  • C11 standard (ISO/IEC 9899:2011):
    • 7.29.4.5.3 The wcspbrk function (p: 436)
  • C99 standard (ISO/IEC 9899:1999):
    • 7.24.4.5.3 The wcspbrk function (p: 382)

See also

(C95)
returns the length of the maximum initial segment that consists
of only the wide chars not found in another wide string
(function)
(C95)
finds the first occurrence of a wide character in a wide string
(function)
finds the first location of any character in one string, in another string
(function)
C++ documentation for wcspbrk

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/c/string/wide/wcspbrk