STRXFRM

NAME

strxfrm - string transformation

SYNOPSIS

#include <string.h>

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

DESCRIPTION

The fBstrxfrm()fP function transforms the fIsrcfP string into a form such that the result of fBstrcmp()fP on two strings that have been transformed with fBstrxfrm()fP is the same as the result of fBstrcoll()fP on the two strings before their transformation. The first fInfP characters of the transformed string are placed in fIdestfP. The transformation is based on the program's current locale for category fILC_COLLATEfP. (See fBsetlocalefP(3)).

RETURN VALUE

The fBstrxfrm()fP function returns the number of bytes required to store the transformed string in fIdestfP excluding the terminating ` ' character. If the value returned is fInfP or more, the contents of fIdestfP are indeterminate.

CONFORMING TO

SVID 3, BSD 4.3, ISO 9899

NOTES

In the fI"POSIX"fP or fI"C"fP locales fBstrxfrm()fP is equivalent to copying the string with fBstrncpy()fP.