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

wcsncmp

Defined in header <wchar.h> 
int wcsncmp( const wchar_t* lhs, const wchar_t* rhs, size_t count );
+		 (since C95)

Compares at most count wide characters of two null-terminated wide strings. The comparison is done lexicographically.

+

The sign of the result is the sign of the difference between the values of the first pair of wide characters that differ in the strings being compared.

+

The behavior is undefined if lhs or rhs are not pointers to null-terminated strings.

+

Parameters

+ + +
lhs, rhs - pointers to the null-terminated wide strings to compare
count - maximum number of characters to compare

Return value

Negative value if lhs appears before rhs in lexicographical order.

+

Zero if lhs and rhs compare equal.

+

Positive value if lhs appears after rhs in lexicographical order.

+

Notes

This function is not locale-sensitive, unlike wcscoll and wcsxfrm.

+

Example

#include <stdio.h>
+#include <wchar.h>
+#include <locale.h>
+ 
+void demo(const wchar_t *lhs, const wchar_t *rhs, int sz)
+{
+    int rc = wcsncmp(lhs, rhs, sz);
+    if(rc == 0)
+        printf("First %d characters of [%ls] equal [%ls]\n", sz, lhs, rhs);
+    else if(rc < 0)
+        printf("First %d characters of [%ls] precede [%ls]\n", sz, lhs, rhs);
+    else if(rc > 0)
+        printf("First %d characters of [%ls] follow [%ls]\n", sz, lhs, rhs);
+}
+ 
+int main(void)
+{
+    const wchar_t *str1 = L"안녕하세요";
+    const wchar_t *str2 = L"안녕히 가십시오";
+ 
+    setlocale(LC_ALL, "en_US.utf8");
+    demo(str1, str2, 5);
+    demo(str2, str1, 8);
+    demo(str1, str2, 2);
+}

Output:

+
First 5 characters of [안녕하세요] precede [안녕히 가십시오]
+First 8 characters of [안녕히 가십시오] follow [안녕하세요]
+First 2 characters of [안녕하세요] equal [안녕히 가십시오]

References

See also

+ + + +
+
(C95)
 compares two wide strings
(function)
+
(C95)
 compares a certain amount of wide characters from two arrays
(function)
+
(C95)
 compares two wide strings in accordance to the current locale
(function)
C++ documentation for wcsncmp
+

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

+
-- cgit v1.2.3