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%2Fwmemchr.html | 51 ++++++++++++++++++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 devdocs/c/string%2Fwide%2Fwmemchr.html (limited to 'devdocs/c/string%2Fwide%2Fwmemchr.html') diff --git a/devdocs/c/string%2Fwide%2Fwmemchr.html b/devdocs/c/string%2Fwide%2Fwmemchr.html new file mode 100644 index 00000000..d2d9a2db --- /dev/null +++ b/devdocs/c/string%2Fwide%2Fwmemchr.html @@ -0,0 +1,51 @@ +

wmemchr

Defined in header <wchar.h> 
wchar_t *wmemchr( const wchar_t *ptr, wchar_t ch, size_t count );
+		 (1) (since C95) 
/*QWchar_t*/ *wmemchr( /*Qwchar_t*/ *ptr, wchar_t ch, size_t count );
+		 (2) (since C23)
+1) Locates the first occurrence of wide character ch in the initial count wide characters of the wide character array or integer array of compatible type, pointed to by ptr.
+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 (wmemchr) or a function pointer is used), the actual function declaration (1) becomes visible.

If count is zero, the function returns a null pointer.

+

Parameters

+ + + +
ptr - pointer to the wide character array to be examined
ch - wide character to search for
count - number of wide characters to examine

Return value

Pointer to the location of the wide character, or a null pointer if no such character is found.

+

Example

#include <locale.h>
+#include <stdio.h>
+#include <wchar.h>
+ 
+int main(void)
+{
+    wchar_t str[] = L"诺不轻信，故人不负我\0诺不轻许，故我不负人。";
+    size_t sz = sizeof str / sizeof *str;
+ 
+    wchar_t target = L'许';
+    wchar_t* result = wmemchr(str, target, sz);
+ 
+    if (result)
+    {
+        setlocale(LC_ALL, "en_US.utf8");
+        printf("Found '%lc' at position %td\n",target, result - str);
+    }
+}

Possible output:

+
Found '许' at position 14

References

See also

+ + +
searches an array for the first occurrence of a character
(function)
+
(C95)
 finds the first occurrence of a wide character in a wide string
(function)
C++ documentation for wmemchr
+

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

+
-- cgit v1.2.3