function
<cwchar>
wcspbrk
const wchar_t* wcspbrk (const wchar_t* wcs1, const wchar_t* wcs2); wchar_t* wcspbrk ( wchar_t* wcs1, const wchar_t* wcs2);
Locate characters in wide string
Returns a pointer to the first occurrence in wcs1 of any of the wide characters that are part of wcs2, or a null pointer if there are no matches.
The search does not include the terminating null wide characters of either wide strings, but ends there.
This is the wide character equivalent of strpbrk (<cstring>).
Parameters
- wcs1
- C wide string to be scanned.
- wcs2
- C wide string containing the characters to match.
Return Value
A pointer to the first occurrence in wcs1 of any of the wide characters that are part of wcs2, or a null pointer if none of the characters of wcs2 is found in wcs1 before the terminating null wide character.
If none of the characters of wcs2 is present in wcs1, a null pointer is returned.
Portability
In C, this function is only declared as:
wchar_t * wcspbrk ( const wchar_t *, const wchar_t * );
instead of the two overloaded versions provided in C++.
Example
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
/* wcspbrk example */
#include <wchar.h>
int main ()
{
wchar_t wcs[] = L"This is a sample wide string";
wchar_t key[] = L"aeiou";
wchar_t * pwc;
wprintf (L"Vowels in '%ls': ",wcs);
pwc = wcspbrk (wcs, key);
while (pwc != NULL)
{
wprintf (L"%c " , *pwc);
pwc = wcspbrk (pwc+1,key);
}
wprintf (L"\n");
return 0;
}
|
Output:
Vowels in 'This is a sample string': i i a a e i e i
|
See also
- strpbrk
- Locate characters in string (function)
- wcscspn
- Get span until character in wide string (function)
- wcschr
- Locate first occurrence of character in wide string (function)
- wcsrchr
- Locate last occurrence of character in wide string (function)
- wmemchr
- Locate character in block of wide characters (function)