Loading...
string/FreeBSD/wcsxfrm.3 Libc-1725.40.4 Libc-583
--- Libc/Libc-1725.40.4/string/FreeBSD/wcsxfrm.3
+++ Libc/Libc-583/string/FreeBSD/wcsxfrm.3
@@ -13,6 +13,10 @@
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"	This product includes software developed by the University of
+.\"	California, Berkeley and its contributors.
 .\" 4. Neither the name of the University nor the names of its contributors
 .\"    may be used to endorse or promote products derived from this software
 .\"    without specific prior written permission.
@@ -31,53 +35,40 @@
 .\"
 .\"     @(#)strxfrm.3	8.1 (Berkeley) 6/4/93
 .\" FreeBSD: src/lib/libc/string/strxfrm.3,v 1.16 2002/09/06 11:24:06 tjr Exp
-.\" $FreeBSD: src/lib/libc/string/wcsxfrm.3,v 1.3 2007/01/09 00:28:12 imp Exp $
+.\" $FreeBSD: src/lib/libc/string/wcsxfrm.3,v 1.2 2002/12/09 14:04:05 ru Exp $
 .\"
 .Dd October 4, 2002
 .Dt WCSXFRM 3
 .Os
 .Sh NAME
-.Nm wcsxfrm ,
-.Nm wcsxfrm_l
+.Nm wcsxfrm
 .Nd transform a wide string under locale
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In wchar.h
 .Ft size_t
-.Fo wcsxfrm
-.Fa "wchar_t *restrict ws1"
-.Fa "const wchar_t *restrict ws2"
-.Fa "size_t n"
-.Fc
-.In wchar.h
-.In xlocale.h
-.Ft size_t
-.Fo wcsxfrm_l
-.Fa "wchar_t *restrict ws1"
-.Fa "const wchar_t *restrict ws2"
-.Fa "size_t n"
-.Fa "locale_t loc"
-.Fc
+.Fn wcsxfrm "wchar_t * restrict dst" "const wchar_t * restrict src" "size_t n"
 .Sh DESCRIPTION
 The
 .Fn wcsxfrm
 function transforms a null-terminated wide character string pointed to by
-.Fa ws2 ,
-according to the current locale's collation order,
-then copies the transformed string into
-.Fa ws1 .
+.Fa src
+according to the current locale collation order
+then copies the transformed string
+into
+.Fa dst .
 No more than
 .Fa n
 wide characters are copied into
-.Fa ws1 ,
-including the terminating null character.
+.Fa dst ,
+including the terminating null character added.
 If
 .Fa n
 is set to 0
 (it helps to determine an actual size needed
 for transformation),
-.Fa ws1
+.Fa dst
 is permitted to be a
 .Dv NULL
 pointer.
@@ -89,14 +80,6 @@
 is equivalent to comparing
 two original strings with
 .Fn wcscoll .
-.Pp
-Although the
-.Fn wcsxfrm
-function uses the current locale, the
-.Fn wcsxfrm_l
-function may be passed a locale directly. See
-.Xr xlocale 3
-for more information.
 .Sh RETURN VALUES
 Upon successful completion,
 .Fn wcsxfrm
@@ -105,14 +88,13 @@
 If this value is
 .Fa n
 or more, the contents of
-.Fa ws1
+.Fa dst
 are indeterminate.
 .Sh SEE ALSO
 .Xr setlocale 3 ,
 .Xr strxfrm 3 ,
 .Xr wcscmp 3 ,
-.Xr wcscoll 3 ,
-.Xr xlocale 3
+.Xr wcscoll 3
 .Sh STANDARDS
 The
 .Fn wcsxfrm
@@ -138,7 +120,7 @@
 .Fn wcscoll ;
 .Fn wcsxfrm
 only stores information about primary collation weights into
-.Fa ws1 ,
+.Fa dst ,
 whereas
 .Fn wcscoll
 compares characters using both primary and secondary weights.