diff options
| author | наб <nabijaczleweli@nabijaczleweli.xyz> | 2024-06-28 17:47:30 +0200 |
|---|---|---|
| committer | Alejandro Colomar <alx@kernel.org> | 2024-06-28 22:09:42 +0200 |
| commit | 26d792e86e714311ae2b93da4d203b90d13a360b (patch) | |
| tree | de8549e7229092f3f93d7374597df66ad3341315 | |
| parent | ef6065583694772837e48653c6fe70f73fc1503d (diff) | |
| download | man-pages-26d792e86e714311ae2b93da4d203b90d13a360b.tar.gz | |
wcscasecmp.3, wcsncasecmp.3: Merge
This mirrors str[n]casecmp and is much more useful,
but more importantly these didn't crosslink at all.
The RETURN VALUE section is now copied from strncasecmp.3.
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Message-ID: <wr4xqnhilpx7yszqxcggo7scpt3bnrfha3ohfs6uxwibhfafel@tarta.nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
| -rw-r--r-- | man/man3/wcscasecmp.3 | 46 | ||||
| -rw-r--r-- | man/man3/wcsncasecmp.3 | 106 |
2 files changed, 29 insertions, 123 deletions
diff --git a/man/man3/wcscasecmp.3 b/man/man3/wcscasecmp.3 index 88d88b2a3d..b696158ded 100644 --- a/man/man3/wcscasecmp.3 +++ b/man/man3/wcscasecmp.3 @@ -10,7 +10,10 @@ .\" .TH wcscasecmp 3 (date) "Linux man-pages (unreleased)" .SH NAME -wcscasecmp \- compare two wide-character strings, ignoring case +wcscasecmp, +wcsncasecmp +\- +compare two wide-character strings, ignoring case .SH LIBRARY Standard C library .RI ( libc ", " \-lc ) @@ -19,6 +22,8 @@ Standard C library .B #include <wchar.h> .P .BI "int wcscasecmp(const wchar_t *" s1 ", const wchar_t *" s2 ); +.BI "int wcsncasecmp(const wchar_t " s1 [. n "], const wchar_t " s2 [. n "], \ +size_t " n ); .fi .P .RS -4 @@ -26,7 +31,8 @@ Feature Test Macro Requirements for glibc (see .BR feature_test_macros (7)): .RE .P -.BR wcscasecmp (): +.BR wcscasecmp (), +.BR wcsncasecmp (): .nf Since glibc 2.10: _POSIX_C_SOURCE >= 200809L @@ -48,27 +54,30 @@ ignoring case differences .RB ( towupper (3), .BR towlower (3)). +.P +The +.BR wcsncasecmp () +function is similar +(the wide-character equivalent of +.BR strncasecmp (3)), +except that it compares no more than +.I n +wide characters of +.I s1 +and +.IR s2 . .SH RETURN VALUE The .BR wcscasecmp () -function returns zero if the wide-character strings at -.I s1 and -.I s2 -are equal except for case distinctions. -It returns a -positive integer if -.I s1 -is greater than -.IR s2 , -ignoring case. -It -returns a negative integer if +.BR wcsncasecmp () +functions return +an integer less than, equal to, or greater than zero if .I s1 -is smaller -than +is, after ignoring case, found to be +less than, to match, or be greater than .IR s2 , -ignoring case. +respectively. .SH ATTRIBUTES For an explanation of the terms used in this section, see .BR attributes (7). @@ -80,7 +89,8 @@ Interface Attribute Value T{ .na .nh -.BR wcscasecmp () +.BR wcscasecmp (), +.BR wcsncasecmp () T} Thread safety MT-Safe locale .TE .SH STANDARDS diff --git a/man/man3/wcsncasecmp.3 b/man/man3/wcsncasecmp.3 index dba58b7476..6e8d682cce 100644 --- a/man/man3/wcsncasecmp.3 +++ b/man/man3/wcsncasecmp.3 @@ -1,105 +1 @@ -'\" t -.\" Copyright (c) Bruno Haible <haible@clisp.cons.org> -.\" -.\" SPDX-License-Identifier: GPL-2.0-or-later -.\" -.\" References consulted: -.\" GNU glibc-2 source code and manual -.\" Dinkumware C library reference http://www.dinkumware.com/ -.\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html -.\" -.TH wcsncasecmp 3 (date) "Linux man-pages (unreleased)" -.SH NAME -wcsncasecmp \- compare two fixed-size wide-character strings, ignoring case -.SH LIBRARY -Standard C library -.RI ( libc ", " \-lc ) -.SH SYNOPSIS -.nf -.B #include <wchar.h> -.P -.BI "int wcsncasecmp(const wchar_t " s1 [. n "], const wchar_t " s2 [. n "], s\ -ize_t " n ); -.fi -.P -.RS -4 -Feature Test Macro Requirements for glibc (see -.BR feature_test_macros (7)): -.RE -.P -.BR wcsncasecmp (): -.nf - Since glibc 2.10: - _POSIX_C_SOURCE >= 200809L - Before glibc 2.10: - _GNU_SOURCE -.fi -.SH DESCRIPTION -The -.BR wcsncasecmp () -function is the wide-character equivalent of the -.BR strncasecmp (3) -function. -It compares the wide-character string pointed to -by -.I s1 -and the wide-character string -pointed to by -.IR s2 , -but at most -.I n -wide characters from each string, ignoring case differences -.RB ( towupper (3), -.BR towlower (3)). -.SH RETURN VALUE -The -.BR wcsncasecmp () -function returns zero -if the wide-character strings at -.I s1 -and -.IR s2 , -truncated to at most length -.IR n , -are equal except -for case distinctions. -It returns a positive integer if truncated -.I s1 -is -greater than truncated -.IR s2 , -ignoring case. -It returns a negative integer -if truncated -.I s1 -is smaller than truncated -.IR s2 , -ignoring case. -.SH ATTRIBUTES -For an explanation of the terms used in this section, see -.BR attributes (7). -.TS -allbox; -lbx lb lb -l l l. -Interface Attribute Value -T{ -.na -.nh -.BR wcsncasecmp () -T} Thread safety MT-Safe locale -.TE -.SH STANDARDS -POSIX.1-2008. -.SH HISTORY -glibc 2.1. -.SH NOTES -The behavior of -.BR wcsncasecmp () -depends on the -.B LC_CTYPE -category of the -current locale. -.SH SEE ALSO -.BR strncasecmp (3), -.BR wcsncmp (3) +.so man3/wcscasecmp.3 |