Print this page
11586 NAME field in man pages should match what's installed

*** 42,56 **** .\" .\" Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. .\" Portions Copyright (c) 2002, Sun Microsystems, Inc. All Rights Reserved .\" Copyright 2014 Garrett D'Amore <garrett@damore.org> .\" ! .TH WCSCOLL 3C "April 9, 2016" .SH NAME ! wcscoll, wcscoll_l wscoll \- wide character string comparison using collating information .SH SYNOPSIS - .LP .nf #include <wchar.h> \fBint\fR \fBwcscoll\fR(\fBconst wchar_t *\fR\fIws1\fR, \fBconst wchar_t *\fR\fIws2\fR); .fi --- 42,55 ---- .\" .\" Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. .\" Portions Copyright (c) 2002, Sun Microsystems, Inc. All Rights Reserved .\" Copyright 2014 Garrett D'Amore <garrett@damore.org> .\" ! .TH WCSCOLL 3C "Aug 20, 2019" .SH NAME ! wcscoll, wcscoll_l, wscoll \- wide character string comparison using collating information .SH SYNOPSIS .nf #include <wchar.h> \fBint\fR \fBwcscoll\fR(\fBconst wchar_t *\fR\fIws1\fR, \fBconst wchar_t *\fR\fIws2\fR); .fi
*** 61,71 **** .LP .nf \fBint\fR \fBwscoll\fR(\fBconst wchar_t *\fR\fIws1\fR, \fBconst wchar_t *\fR\fIws2\fR); .fi .SH DESCRIPTION - .LP The \fBwcscoll()\fR, \fBwcscoll_l()\fR, and \fBwscoll()\fR functions compare the wide character string pointed to by \fIws1\fR to the wide character string pointed to by \fIws2\fR, both interpreted as appropriate to the \fBLC_COLLATE\fR locale category. --- 60,69 ----
*** 78,113 **** .LP The function \fBwcsoll_l()\fR behaves identically to \fBwcsoll\fR(), except instead of operating in the current locale, it operates in the locale specified by \fIloc\fR. .SH RETURN VALUES - .LP Upon successful completion, these functions return an integer greater than, equal to, or less than 0, depending upon whether the wide character string pointed to by \fIws1\fR is greater than, equal to, or less than the wide character string pointed to by \fIws2\fR, when both are interpreted as appropriate to the current locale, or the locale specified by \fIloc\fR. On error, they set \fBerrno\fR, but no return value is reserved to indicate an error. .SH ERRORS - .LP The \fBwcscoll()\fR, \fBwcscoll_l()\fR and \fBwscoll()\fR functions may fail if: .sp .ne 2 .na ! \fB\fBEINVAL\fR\fR .ad .RS 10n The \fIws1\fR or \fIws2\fR arguments contain wide character codes outside the domain of the collating sequence. .RE .SH USAGE - .LP The \fBwcsxfrm\fR(3C) and \fBwcscmp\fR(3C) functions should be used for sorting large lists, or when performing many comparisons on the same strings. .SH ATTRIBUTES - .LP See \fBattributes\fR(5) for descriptions of the following attributes: .TS box; c | c l | l . --- 76,107 ---- .LP The function \fBwcsoll_l()\fR behaves identically to \fBwcsoll\fR(), except instead of operating in the current locale, it operates in the locale specified by \fIloc\fR. .SH RETURN VALUES Upon successful completion, these functions return an integer greater than, equal to, or less than 0, depending upon whether the wide character string pointed to by \fIws1\fR is greater than, equal to, or less than the wide character string pointed to by \fIws2\fR, when both are interpreted as appropriate to the current locale, or the locale specified by \fIloc\fR. On error, they set \fBerrno\fR, but no return value is reserved to indicate an error. .SH ERRORS The \fBwcscoll()\fR, \fBwcscoll_l()\fR and \fBwscoll()\fR functions may fail if: .sp .ne 2 .na ! \fBEINVAL\fR .ad .RS 10n The \fIws1\fR or \fIws2\fR arguments contain wide character codes outside the domain of the collating sequence. .RE .SH USAGE The \fBwcsxfrm\fR(3C) and \fBwcscmp\fR(3C) functions should be used for sorting large lists, or when performing many comparisons on the same strings. .SH ATTRIBUTES See \fBattributes\fR(5) for descriptions of the following attributes: .TS box; c | c l | l .
*** 122,130 **** .LP The \fBwcscoll()\fR and \fBwcscoll_l()\fR functions are Standard. The \fBwscoll()\fR function is Committed. .SH SEE ALSO - .LP \fBnewlocale\fR(3C), \fBsetlocale\fR(3C), \fBuselocale\fR(3C), \fBwcscmp\fR(3C), \fBwcsxfrm\fR(3C), \fBattributes\fR(5), \fBstandards\fR(5) --- 116,123 ----