strxfrm(3) [mojave man page]

STRXFRM(3)						   BSD Library Functions Manual 						STRXFRM(3)

NAME

     strxfrm, strxfrm_l -- transform a string under locale

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <string.h>

     size_t
     strxfrm(char *restrict s1, const char *restrict s2, size_t n);

     #include <string.h>
     #include <xlocale.h>

     size_t
     strxfrm_l(char *restrict s1, const char *restrict s2, size_t n, locale_t loc);

DESCRIPTION

     The strxfrm() function transforms a null-terminated string pointed to by s2 according to the current locale collation if any, then copies the
     transformed string into s1.  Not more than n characters are copied into s1, including the terminating null character added.  If n is set to 0
     (it helps to determine an actual size needed for transformation), s1 is permitted to be a NULL pointer.

     Comparing two strings using strcmp() after strxfrm() is equal to comparing two original strings with strcoll().

     Although the strxfrm() function uses the current locale, the strxfrm_l() function may be passed a locale directly. See xlocale(3) for more
     information.

RETURN VALUES

     Upon successful completion, strxfrm() returns the length of the transformed string not including the terminating null character.  If this
     value is n or more, the contents of s1 are indeterminate.

SEE ALSO

     setlocale(3), strcmp(3), strcoll(3), wcsxfrm(3), xlocale(3)

STANDARDS

     The strxfrm() function conforms to ISO/IEC 9899:1990 (``ISO C90'').

BSD
								   June 4, 1993 							       BSD

Check Out this Related Man Page

STRXFRM(3)						     Linux Programmer's Manual							STRXFRM(3)

NAME

       strxfrm - string transformation

SYNOPSIS

       #include <string.h>

       size_t strxfrm(char *dest, const char *src, size_t n);

DESCRIPTION

       The  strxfrm()  function  transforms  the src string into a form such that the result of strcmp() on two strings that have been transformed
       with strxfrm() is the same as the result of strcoll() on the two strings before their transformation.  The first n characters of the trans-
       formed  string  are  placed  in	dest.	The  transformation is based on the program's current locale for category LC_COLLATE.  (See setlo-
       cale(3)).

RETURN VALUE

       The strxfrm() function returns the number of bytes required to store the transformed string in dest excluding the terminating `'  charac-
       ter.  If the value returned is n or more, the contents of dest are indeterminate.

CONFORMING TO

       SVID 3, BSD 4.3, ISO 9899

NOTES

       In the "POSIX" or "C" locales strxfrm() is equivalent to copying the string with strncpy().

SEE ALSO

       bcmp(3), memcmp(3), strcasecmp(3), strcmp(3), strcoll(3), setlocale(3)

GNU
								    1993-04-12								STRXFRM(3)

Linux and UNIX Man Pages

strxfrm(3) [mojave man page]

Check Out this Related Man Page