Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

strxfrm(3) [osx 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)						   BSD Library Functions Manual 						STRXFRM(3)

NAME
strxfrm -- transform a string under locale LIBRARY
Standard C Library (libc, -lc) SYNOPSIS
#include <string.h> size_t strxfrm(char * restrict dst, const char * restrict src, size_t n); size_t strxfrm_l(char * restrict dst, const char *restrict src, size_t n, locale_t loc); DESCRIPTION
The strxfrm() function transforms a null-terminated string pointed to by src according to the current locale collation if any, then copies the transformed string into dst. Not more than n characters are copied into dst, including the terminating null character added. If n is set to 0 (it helps to determine an actual size needed for transformation), dst is permitted to be a NULL pointer. Comparing two strings using strcmp() after strxfrm() is equal to comparing two original strings with strcoll(). strxfrm_l() does the same, however takes an explicit locale rather than the global locale. RETURN VALUES
Upon successful completion, strxfrm() and strxfrm_l() return the length of the transformed string not including the terminating null charac- ter. If this value is n or more, the contents of dst are indeterminate. SEE ALSO
setlocale(3), strcmp(3), strcoll(3), wcsxfrm(3) STANDARDS
The strxfrm() function conforms to ISO/IEC 9899:1990 (``ISO C90''). The strxfrm_l() function conforms to IEEE Std 1003.1-2008 (``POSIX.1''). BSD
June 4, 1993 BSD
Man Page