STRXFRM(3)

NOME
strxfrm - transformação de seqüencias de caracteres

SINÓPSE
#include <string.h>

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

DESCRIÇÃO
A função strxfrm() transforma a seqüencia org em uma forma tal que o resultado de strcmp() em duas seqüencias que tenham sido transformadas com strxfrm() é o mesmo que o resultado de strcoll() nas duas seqüencias antes da transformção. Os primeiros n caracteres da seqüencia transformada são colocados em dest. A transformação é baseada nas configurações regionais atuais do programa para categoria LC_COLLATE. (Veja setlocale(3)).

VALORES RETORNAODOS
A função strxfrm() retorna o número de bytes necessários para armazenar a seqüencia transformada em dest excluindo o caractere terminador `\0'. Se o valor retornado for n ou mais, o conteúdo de dest é indeterminado.

DE ACOROD COM
SVID 3, BSD 4.3, ISO 9899.

NOTAS
Nas localizações 'POSIX' ou 'C', strxfrm() é equivalente a copiar a seqüencia com strncpy().

VEJA TAMBÉM
bcmp(3), memcmp(3), strcasecmp(3), strcmp(3), strcoll(3), setlocale(3).

TRADUZIDO POR LDP-BR em 15/03/2001.

  Tradução:
Marcelo M. de Abreu <mmabreu@terra.com.br>

  Revsisão.:
André Luiz Fassone <lonely_wolf@ig.com.br>