Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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);

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 compar-
     ing two original strings with strcoll().

RETURN VALUES
     Upon successful completion, strxfrm() returns the length of the trans-
     formed string not including the terminating null character.  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").

BSD				 June 4, 1993				   BSD

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | SEE ALSO | STANDARDS

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=strxfrm&sektion=3&manpath=FreeBSD+6.4-RELEASE>

home | help