Loading...
--- Libc/Libc-583/string/strxfrm.3
+++ Libc/Libc-262/string/strxfrm.3
@@ -34,54 +34,40 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)strxfrm.3 8.1 (Berkeley) 6/4/93
-.\" $FreeBSD: src/lib/libc/string/strxfrm.3,v 1.17 2002/10/15 10:11:53 tjr Exp $
+.\" $FreeBSD: src/lib/libc/string/strxfrm.3,v 1.14 2001/10/01 16:09:00 ru Exp $
.\"
.Dd June 4, 1993
.Dt STRXFRM 3
.Os
.Sh NAME
-.Nm strxfrm ,
-.Nm strxfrm_l
+.Nm strxfrm
.Nd transform a string under locale
.Sh LIBRARY
.Lb libc
.Sh SYNOPSIS
.In string.h
.Ft size_t
-.Fo strxfrm
-.Fa "char *restrict s1"
-.Fa "const char *restrict s2"
-.Fa "size_t n"
-.Fc
-.In string.h
-.In xlocale.h
-.Ft size_t
-.Fo strxfrm_l
-.Fa "char *restrict s1"
-.Fa "const char *restrict s2"
-.Fa "size_t n"
-.Fa "locale_t loc"
-.Fc
+.Fn strxfrm "char *dst" "const char *src" "size_t n"
.Sh DESCRIPTION
The
.Fn strxfrm
function transforms a null-terminated string pointed to by
-.Fa s2
+.Fa src
according to the current locale collation if any,
then copies the transformed string
into
-.Fa s1 .
+.Fa dst .
Not more than
.Fa n
characters are copied into
-.Fa s1 ,
+.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 s1
+.Fa dst
is permitted to be a NULL pointer.
.Pp
Comparing two strings using
@@ -91,14 +77,6 @@
is equal to comparing
two original strings with
.Fn strcoll .
-.Pp
-Although the
-.Fn strxfrm
-function uses the current locale, the
-.Fn strxfrm_l
-function may be passed a locale directly. See
-.Xr xlocale 3
-for more information.
.Sh RETURN VALUES
Upon successful completion,
.Fn strxfrm
@@ -107,14 +85,12 @@
If this value is
.Fa n
or more, the contents of
-.Fa s1
+.Fa dst
are indeterminate.
.Sh SEE ALSO
.Xr setlocale 3 ,
.Xr strcmp 3 ,
-.Xr strcoll 3 ,
-.Xr wcsxfrm 3 ,
-.Xr xlocale 3
+.Xr strcoll 3
.Sh STANDARDS
The
.Fn strxfrm