strxfrm(3) transformación de cadena de caracteres

SINOPSIS

#include <string.h>


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

DESCRIPCIÓN

La función strxfrm() transforma la cadena de caracteres orig a una forma tal que el resultado de llamar a strcmp() sobre dos cadenas que han sido transformadas mediante strxfrm() es el mismo que el de llamar a strcoll() en las dos cadenas antes de su transformación. Los primeros n caracteres de la cadena transformada se colocan en dest. La transformación se basa en la localización en curso para la categoría LC_COLLATE. (Vea setlocale(3)).

VALOR DEVUELTO

La función strxfrm() devuelve el número de bytes requeridos para guardar la cadena transformada en dest excluyendo el carácter terminador '\0'. Si el valor devuelto es n o más, los contenidos de dest son indeterminados.

CONFORME A

SVID 3, BSD 4.3, ISO 9899

OBSERVACIONES

En las localizaciones "POSIX" o "C", strxfrm() es equivalente a copiar la cadena con strncpy().