summaryrefslogtreecommitdiffstats
path: root/lib/libc/string/strxfrm.3
diff options
context:
space:
mode:
Diffstat (limited to 'lib/libc/string/strxfrm.3')
-rw-r--r--lib/libc/string/strxfrm.327
1 files changed, 18 insertions, 9 deletions
diff --git a/lib/libc/string/strxfrm.3 b/lib/libc/string/strxfrm.3
index ccd8bcb..308f942 100644
--- a/lib/libc/string/strxfrm.3
+++ b/lib/libc/string/strxfrm.3
@@ -48,16 +48,25 @@
.Sh DESCRIPTION
The
.Fn strxfrm
-function
-does something horrible (see
-.Tn ANSI
-standard).
-In this implementation it just copies.
+function transforms a null-terminated string pointed to by
+.Fa src
+according to the current locale collation if any,
+then copies not more than
+.Fa n-1
+characters of the resulting string into
+.Fa dst ,
+terminating it with a null character and then returns the resulting length.
+Comparing two strings using
+.Fn strcmp
+after
+.Fn strxfrm
+is equal to comparing
+two original strings with
+.Fn strcoll .
+.Sh BUGS
+Sometimes the behavior of this function is unpredictable.
.Sh SEE ALSO
-.Xr bcmp 3 ,
-.Xr memcmp 3 ,
-.\" .Xr setlocale 3 ,
-.Xr strcasecmp 3 ,
+.Xr setlocale 3 ,
.Xr strcmp 3 ,
.Xr strcoll 3
.Sh STANDARDS
OpenPOWER on IntegriCloud