From 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Sun, 7 Apr 2024 13:41:34 -0500 Subject: new repository --- devdocs/c/string%2Fwide%2Fwcspbrk.html | 47 ++++++++++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) create mode 100644 devdocs/c/string%2Fwide%2Fwcspbrk.html (limited to 'devdocs/c/string%2Fwide%2Fwcspbrk.html') diff --git a/devdocs/c/string%2Fwide%2Fwcspbrk.html b/devdocs/c/string%2Fwide%2Fwcspbrk.html new file mode 100644 index 00000000..f6d7a55a --- /dev/null +++ b/devdocs/c/string%2Fwide%2Fwcspbrk.html @@ -0,0 +1,47 @@ +

wcspbrk

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 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

#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

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 +

+
-- cgit v1.2.3