wcspbrk
From cppreference.com
C
Concurrency support (C11)
Null-terminated wide strings
(C95)
(C95)
(C95)
(C95)
(C95)
(C95)
(C99)
(C95)(C99)
(C99)(C95)(C99)
(C95)(C11)
(C95)(C11)
(C95)
(C95)(C95)
(C95)(C95)
(C95)
Defined in header
<wchar.h>
wchar_t *wcspbrk( const wchar_t *dest, const wchar_t *str );
(1)
(since C95)
/*QWchar_t*/ *wcspbrk( /*QWchar_t*/ *dest, const wchar_t *str );
(2)
(since C23)
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
destis of type const T*, the return type is const wchar_t*. - Otherwise, if
destis of type T*, the return type is wchar_t*. - Otherwise, the behavior is undefined.
- If
[edit] 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
[edit] Return value
Pointer to the first character in dest, that is also in str, or a null pointer if no such character exists.
[edit] Notes
The name stands for "wide character string pointer break", because it returns a pointer to the first of the separator ("break") characters.
[edit] 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.
[edit] 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)
[edit] See also
(C95)
of only the wide chars not found in another wide string
(function) [edit]
C++ documentation for wcspbrk