CREATE CONVERSION

Nom

CREATE CONVERSION -- d�finit une nouvelle conversion d'encodage

Synopsis

CREATE [DEFAULT] CONVERSION nom
    FOR codage_source TO codage_dest FROM fonction

Description

CREATE CONVERSION d�finit une nouvelle conversion entre des codages d'ensembles de caract�res. Les noms de conversion pourront �tre utilis�s dans la fonction convert pour sp�cifier une conversion de codage particuli�re. De plus, les conversions marqu�es DEFAULT peuvent �tre utilis�es pour une conversion de codage automatique entre le client et le serveur. Pour y arriver, deux conversions, du codage A � B et du codage B � A, doivent �tre d�finies.

Pour �tre capable de cr�er conversion, vous devez avoir le droit EXECUTE sur la fonction et le droit CREATE sur le sch�ma de destination.

Param�tres

DEFAULT

La clause DEFAULT indique que cette conversion est celle par d�faut pour un codage de cette source vers cette destination. Il ne doit y avoir qu'un codage par d�faut dans un sch�ma pour une paire de codage.

nom

Le nom de la conversion. Ce nom pourrait �tre qualifi� avec le nom du sch�ma. Si ce n'est pas le cas, la conversion est d�finie dans le sch�ma actuel. Le nom de la conversion doit �tre unique dans un sch�ma.

codage_source

Le nom du codage source.

codage_dest

Le nom du codage destination.

fonction

La fonction utilis�e pour r�aliser la conversion. Le nom de la fonction pourrait �tre qualifi� avec le nom du sch�ma. Si ce n'est pas le cas, la fonction sera cherch�e dans le chemin.

La fonction doit avoir la signature suivante :

conv_proc(
    integer,  -- ID codage source
    integer,  -- ID codage destination
    cstring,  -- cha�ne source (cha�ne C termin�e par un caract�re nul)
    internal, -- destination (rempli avec une cha�ne C termin�e par un caract�re nul)
    integer   -- longueur de la cha�ne source
) RETURNS void;

Notes

Utilisez DROP CONVERSION pour supprimer une conversion d�finie par l'utilisateur.

Les droits requis pour cr�er une conversion pourraient �tre modifi�es dans une version ult�rieure.

Exemples

Pour cr�er une conversion du codage UNICODE vers le codage LATIN1 en utilisant mafonc :

CREATE CONVERSION maconv FOR 'UNICODE' TO 'LATIN1' FROM mafonc;

Compatibilit�

CREATE CONVERSION est une extension PostgreSQL. Il n'existe pas d'instruction CREATE CONVERSION dans le standard SQL.

Voir aussi

ALTER CONVERSION, CREATE FUNCTION, DROP CONVERSION