wcspbrk

Functions

Character manipulation

iswalnum (哋它亢95)
iswalpha (哋它亢95)
iswlower (哋它亢95)
iswupper (哋它亢95)
iswdigit (哋它亢95)
iswxdigit (哋它亢95)
iswblank (哋它亢99)
wctype (哋它亢95)
iswctype (哋它亢95)

iswcntrl (哋它亢95)
iswgraph (哋它亢95)
iswspace (哋它亢95)
iswprint (哋它亢95)
iswpunct (哋它亢95)
towlower (哋它亢95)
towupper (哋它亢95)
wctrans (哋它亢95)
towctrans (哋它亢95)

Conversions to numeric formats

wcstolwcstoll (哋它亢95)(哋它亢99)
wcstoulwcstoull (哋它亢95)(哋它亢99)

wcstofwcstodwcstold (哋它亢99)(哋它亢95)(哋它亢99)
wcstoimaxwcstoumax (哋它亢99)(哋它亢99)

String manipulation

wcslenwcsnlen_s (哋它亢95)(哋它亢11)
wcscpywcscpy_s (哋它亢95)(哋它亢11)
wcsncpywcsncpy_s (哋它亢95)(哋它亢11)
wcscatwcscat_s (哋它亢95)(哋它亢11)
wcsncatwcsncat_s (哋它亢95)(哋它亢11)
wcsstr (哋它亢95)

wcscmp (哋它亢95)
wcsncmp (哋它亢95)
wcscoll (哋它亢95)
wcsxfrm (哋它亢95)
wcschr (哋它亢95)
wcsrchr (哋它亢95)
wcspbrk (哋它亢95)
wcsspn (哋它亢95)
wcscspn (哋它亢95)
wcstokwcstok_s (哋它亢95)(哋它亢11)

Array manipulation

wmemcpywmemcpy_s (哋它亢95)(哋它亢11)
wmemmovewmemmove_s (哋它亢95)(哋它亢11)

wmemcmp (哋它亢95)
wmemchr (哋它亢95)
wmemset (哋它亢95)

Defined in header `<wchar.h>`
wchar_t wcspbrk( const wchar_t dest, const wchar_t *str );	(1)	(since 哋它亢95)
/QWchar_t/ wcspbrk( /QWchar_t/ dest, const wchar_t *str );	(2)	(since 哋它亢23)

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

2) Type-generic function equivalent to (1). Let T be an unqualified wide character object type.

If dest is of type const T*, the return type is const wchar_t*.
Otherwise, if dest is of type T*, the return type is wchar_t*.
Otherwise, the behavior is undefined.

If a macro definition of each of these generic functions is suppressed to access an actual function (e.g. if (wcspbrk) or a function pointer is used), the actual function declaration (1) becomes visible.

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

Run this code

#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

哋它亢11 standard (ISO/IEC 9899:2011):

7.29.4.5.3 The wcspbrk function (p: 436)

哋它亢99 standard (ISO/IEC 9899:1999):

7.24.4.5.3 The wcspbrk function (p: 382)

Language
Headers
Type support
Program utilities
Variadic function support
Error handling
Dynamic memory management
Strings library
Algorithms
Numerics
Date and time utilities
Input/output support
Localization support
Concurrency support (哋它亢11)
Technical Specifications
Symbol index

wcscspn (哋它亢95)	returns the length of the maximum initial segment that consists of only the wide chars not found in another wide string (function)
wcschr (哋它亢95)	finds the first occurrence of a wide character in a wide string (function)
strpbrk	finds the first location of any character in one string, in another string (function)