diff options
Diffstat (limited to 'lib/libc/string/strxfrm.3')
| -rw-r--r-- | lib/libc/string/strxfrm.3 | 23 |
1 files changed, 19 insertions, 4 deletions
diff --git a/lib/libc/string/strxfrm.3 b/lib/libc/string/strxfrm.3 index 308f942fad53..ebe6bd03fa84 100644 --- a/lib/libc/string/strxfrm.3 +++ b/lib/libc/string/strxfrm.3 @@ -51,11 +51,21 @@ The 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 +then copies the resulting string +into +.Fa dst . +Not more than +.Fa n +characters are copied into .Fa dst , -terminating it with a null character and then returns the resulting length. +including the terminating null character added. +If +.Fa n +is set to 0, +.Fa dst +is permitted to be a NULL pointer (it helps to determine an actual size needed +for transformation). +.Pp Comparing two strings using .Fn strcmp after @@ -63,6 +73,11 @@ after is equal to comparing two original strings with .Fn strcoll . +.Sh RETURN VALUES +Upon successful completion, +.Fn strxfrm +returns the length of the transformed string not including +the terminating null character. .Sh BUGS Sometimes the behavior of this function is unpredictable. .Sh SEE ALSO |