| Documentation PostgreSQL 7.4.29 | ||||
|---|---|---|---|---|
| Précédent | Arrière rapide | Chapitre 9. Fonctions et opérateurs | Avance rapide | Suivant |
Cette section décrit les fonctions et opérateurs pour examiner et manipuler des valeurs de type chaîne de caractères. Dans ce contexte, les chaînes incluent les valeurs des types character, character varying et text. Sauf cas contraire précisé, toutes les fonctions listées ci-dessous fonctionnent sur tous ces types mais faites attention des effets potentiels du remplissage automatique lors de l'utilisation du type character. Généralement, les fonctions décrites ici fonctionnent aussi sur les données d'autres types en convertissant au préalable la donnée en une représentation de type chaîne. Quelques fonctions existent aussi nativement pour le type chaînes bit à bit.
SQL définit quelques fonctions de type chaîne avec une syntaxe particulière où certains mots clés sont utilisés à la place de virgule pour séparer les arguments. Des détails sont disponibles dans Tableau 9-6. Ces fonctions sont aussi implémentées en utilisant la syntaxe rationnelle pour l'appel de fonctions. (Voir Tableau 9-7.)
Tableau 9-6. Fonctions et opérateurs SQL pour le type chaîne
| Fonction | Type renvoyé | Description | Exemple | Résultat |
|---|---|---|---|---|
| string || string | text | Concaténation de chaîne | 'Post' || 'greSQL' | PostgreSQL |
bit_length
(string) | integer | Nombre de bits dans une chaîne | bit_length('jose') | 32 |
char_length
(string) ou
character_length
(string) | integer | Nombre de caractères dans une chaîne | char_length('jose') | 4 |
convert(string
using nom_conversion) | text | Modifie le codage en utilisant le nom de conversion cité. Les conversions peuvent être définies par CREATE CONVERSION. De même, il existe quelques noms de conversion pré-définis. Voir Tableau 9-8 pour les noms de conversion disponibles. | convert('PostgreSQL' using iso_8859_1_to_utf_8) | 'PostgreSQL' in Unicode (UTF-8) encoding |
lower
(string) | text | Convertit une chaîne en minuscule | lower('TOM') | tom |
octet_length(string) | integer | Nombre d'octets dans une chaîne | octet_length('jose') | 4 |
overlay(string
placing string from integer [for
integer]) | text | Remplace la sous-chaîne | overlay('Txxxxas' placing 'hom' from 2 for 4) | Thomas |
position(substring
in string) | integer | Emplacement des sous-chaînes spécifiées | position('om' in 'Thomas') | 3 |
substring(string
[from integer] [for
integer]) | text | Extrait une sous-chaîne | substring('Thomas' from 2 for 3) | hom |
substring(string
from modele) | text | Extrait une sous-chaîne correspondant à l'expression rationnelle POSIX | substring('Thomas' from '...$') | mas |
substring(string
from pattern for
escape) | text | Extrait une sous-chaîne correspondant à l'expression rationnelle SQL | substring('Thomas' from '%#"o_a#"_' for '#') | oma |
trim([leading | trailing |
both]
[caractères] from
chaîne)
| text | Supprime la plus grande chaîne contenant seulement les caractères (un espace par défaut) à partir du début, de la fin ou des deux extrémités (respectivement start, end, both) de la chaîne. | trim(both 'x' from 'xTomxx') | Tom |
upper
(string) | text | Convertit une chaîne en majuscule | upper('tom') | TOM |
D'autres fonctions de manipulation de chaînes sont disponibles et listées dans Tableau 9-7. Certaines d'entre elles sont utilisées en interne pour implémenter les fonctions de chaîne répondant au standard SQL listées dans Tableau 9-6.
Tableau 9-7. Autres fonctions de chaîne
| Fonction | Type renvoyé | Description | Exemple | Résultat |
|---|---|---|---|---|
ascii(text) | integer | Code ASCII du premier caractère de l'argument | ascii('x') | 120 |
btrim(chaîne
text, characaractères
text) | text | Supprime la chaîne la plus longue consistant seulement de caractères compris dans caractères entre le début et la fin de string. | btrim('xyxtrimyyx', 'xy') | trim |
chr(integer) | text | Caractère correspondant au code ASCII donné | chr(65) | A |
convert(chaîne
text,
[codage_source
name,]
codage_destination name)
| text | Convertit une chaîne dans le codage codage_destination. Le codage initial est spécifié par codage_source. Si codage_source est omis, le codage de la base de données est pris en compte. | convert( 'texte_en_unicode', 'UNICODE', 'LATIN1') | texte_en_unicode représenté dans le codage ISO 8859-1 |
decode(chaîne
text,
type text)
| bytea | Décode les données binaires à partir de chaîne
codées auparavant avec encode. Le type de paramètre est le
même que encode.
| decode('MTIzAAE=', 'base64') | 123\000\001 |
encode(données
bytea,
type text)
| text | Code les données binaires en une représentation en ASCII uniquement. Les types supportés sont : base64, hex, escape. | encode( '123\\000\\001', 'base64') | MTIzAAE= |
initcap(text) | text | Convertit la première lettre de chaque mot (séparé par des espaces blancs) en majuscule | initcap('bonjour thomas') | Bonjour Thomas |
length
(chaîne) | integer | Nombre de caractères dans la chaîne | length('jose') | 4 |
lpad(chaîne
text,
longueur integer
[, remplissage
text])
| text | Remplit chaîne pour avoir une chaîne de longueur longueur en ajoutant les caractères remplissage (un espace par défaut). Si chaîne a un taille supérieure à longueur, alors elle est tronquée (sur la droite). | lpad('hi', 5, 'xy') | xyxhi |
ltrim(chaîne
text, caractères
text) | text | Supprime la chaîne la plus longue contenant seulement les caractères de characters à partir du début de la chaîne. | ltrim('zzzytrim', 'xyz') | trim |
md5(string
text) | text | Calcule la clé MD5 d'une chaîne donnée, renvoyant le résultat en hexadécimal. | md5('abc') | 900150983cd24fb0 d6963f7d28e17f72 |
pg_client_encoding() | name | Nom du codage client actuel | pg_client_encoding() | SQL_ASCII |
quote_ident(chaîne
text) | text | Renvoie la chaîne entre guillemets à utiliser comme identifiant dans une chaîne d'instructions SQL. Les guillemets sont seulement ajoutés si nécessaire (c'est-à-dire si la chaîne contient des caractères non identifiants). Les guillemets faisant partie de la chaîne sont doublés. | quote_ident('Foo') | "Foo" |
quote_literal(string
text) | text | Renvoie la chaîne correctement entre guillemets pour être utilisée comme une chaîne littérale dans une chaîne d'instructions SQL. Les guillemets compris dans la chaîne et les anti-slash sont correctement doublés. | quote_literal( 'O\'Reilly') | 'O''Reilly' |
repeat(text,
integer) | text | Repère le texte un certain nombre de fois | repeat('Pg', 4) | PgPgPgPg |
replace(chaîne
text,
àpartirde text,
vers text) | text | Remplace dans chaîne toutes les occurrences de la sous-chaîne àpartirde avec la sous-chaîne vers. | replace( 'abcdefabcdef', 'cd', 'XX') | abXXefabXXef |
rpad(chaîne
text,
longueur integer
[, remplissage
text])
| text | Remplit chaîne sur une longueur de longueur caractères en ajoutant les caractères remplissage (un espace par défaut). Si la chaîne a une taille supérieure à longueur, elle est tronquée. | rpad('hi', 5, 'xy') | hixyx |
rtrim(chaîne
text, caractères text) | text | Supprime la chaîne la plus longue contenant uniquement les caractères provenant de characters depuis la fin de la chaîne. | rtrim('trimxxxx', 'x') | trim |
split_part(chaîne
text,
délimiteur text,
champ integer) | text | Divise chaîne par rapport au délimiteur et renvoie le champ donné (en comptant à partir de 1) | split_part( 'abc~@~def~@~ghi', '~@~', 2) | def |
strpos(chaîne,
sous-chaîne) | int | Emplacement de la sous-chaîne spécifiée (identique à position(sous-chaîne in sous-chaîne), mais notez l'ordre inverse des arguments) | strpos('high', 'ig') | 2 |
substr(chaîne,
from [,
nombre]) | text | Extrait la sous-chaîne (identique à substring(chaîne from àpartirde for nombre)) | substr('alphabet', 3, 2) | ph |
to_ascii(text
[,
codage]) | text | Convertit le texte en ASCII à partir de n'importe quelle autre forme de codage [a] | to_ascii('Karel') | Karel |
to_hex(nombre
integer
ou bigint) | text | Convertit nombre dans sa représentation hexadécimale équivalente | to_hex(2147483647) | 7fffffff |
translate(chaîne
text,
àpartirde text,
vers text)
| text | Tout caractère dans chaîne qui correspond à un caractère dans l'ensemble àpartirde est remplacé par le caractère correspondant dans l'ensemble vers. | translate('12345', '14', 'ax') | a23x5 |
| Remarques : a. La fonction to_ascii supporte la conversion de
LATIN1, LATIN2 et WIN1250
uniquement.
| ||||
Tableau 9-8. Conversions intégrées
| Nom de la conversion [a] | Codage source | Codage destination |
|---|---|---|
| ascii_to_mic | SQL_ASCII | MULE_INTERNAL |
| ascii_to_utf_8 | SQL_ASCII | UNICODE |
| big5_to_euc_tw | BIG5 | EUC_TW |
| big5_to_mic | BIG5 | MULE_INTERNAL |
| big5_to_utf_8 | BIG5 | UNICODE |
| euc_cn_to_mic | EUC_CN | MULE_INTERNAL |
| euc_cn_to_utf_8 | EUC_CN | UNICODE |
| euc_jp_to_mic | EUC_JP | MULE_INTERNAL |
| euc_jp_to_sjis | EUC_JP | SJIS |
| euc_jp_to_utf_8 | EUC_JP | UNICODE |
| euc_kr_to_mic | EUC_KR | MULE_INTERNAL |
| euc_kr_to_utf_8 | EUC_KR | UNICODE |
| euc_tw_to_big5 | EUC_TW | BIG5 |
| euc_tw_to_mic | EUC_TW | MULE_INTERNAL |
| euc_tw_to_utf_8 | EUC_TW | UNICODE |
| gb18030_to_utf_8 | GB18030 | UNICODE |
| gbk_to_utf_8 | GBK | UNICODE |
| iso_8859_10_to_utf_8 | LATIN6 | UNICODE |
| iso_8859_13_to_utf_8 | LATIN7 | UNICODE |
| iso_8859_14_to_utf_8 | LATIN8 | UNICODE |
| iso_8859_15_to_utf_8 | LATIN9 | UNICODE |
| iso_8859_16_to_utf_8 | LATIN10 | UNICODE |
| iso_8859_1_to_mic | LATIN1 | MULE_INTERNAL |
| iso_8859_1_to_utf_8 | LATIN1 | UNICODE |
| iso_8859_2_to_mic | LATIN2 | MULE_INTERNAL |
| iso_8859_2_to_utf_8 | LATIN2 | UNICODE |
| iso_8859_2_to_windows_1250 | LATIN2 | WIN1250 |
| iso_8859_3_to_mic | LATIN3 | MULE_INTERNAL |
| iso_8859_3_to_utf_8 | LATIN3 | UNICODE |
| iso_8859_4_to_mic | LATIN4 | MULE_INTERNAL |
| iso_8859_4_to_utf_8 | LATIN4 | UNICODE |
| iso_8859_5_to_koi8_r | ISO_8859_5 | KOI8 |
| iso_8859_5_to_mic | ISO_8859_5 | MULE_INTERNAL |
| iso_8859_5_to_utf_8 | ISO_8859_5 | UNICODE |
| iso_8859_5_to_windows_1251 | ISO_8859_5 | WIN |
| iso_8859_5_to_windows_866 | ISO_8859_5 | ALT |
| iso_8859_6_to_utf_8 | ISO_8859_6 | UNICODE |
| iso_8859_7_to_utf_8 | ISO_8859_7 | UNICODE |
| iso_8859_8_to_utf_8 | ISO_8859_8 | UNICODE |
| iso_8859_9_to_utf_8 | LATIN5 | UNICODE |
| johab_to_utf_8 | JOHAB | UNICODE |
| koi8_r_to_iso_8859_5 | KOI8 | ISO_8859_5 |
| koi8_r_to_mic | KOI8 | MULE_INTERNAL |
| koi8_r_to_utf_8 | KOI8 | UNICODE |
| koi8_r_to_windows_1251 | KOI8 | WIN |
| koi8_r_to_windows_866 | KOI8 | ALT |
| mic_to_ascii | MULE_INTERNAL | SQL_ASCII |
| mic_to_big5 | MULE_INTERNAL | BIG5 |
| mic_to_euc_cn | MULE_INTERNAL | EUC_CN |
| mic_to_euc_jp | MULE_INTERNAL | EUC_JP |
| mic_to_euc_kr | MULE_INTERNAL | EUC_KR |
| mic_to_euc_tw | MULE_INTERNAL | EUC_TW |
| mic_to_iso_8859_1 | MULE_INTERNAL | LATIN1 |
| mic_to_iso_8859_2 | MULE_INTERNAL | LATIN2 |
| mic_to_iso_8859_3 | MULE_INTERNAL | LATIN3 |
| mic_to_iso_8859_4 | MULE_INTERNAL | LATIN4 |
| mic_to_iso_8859_5 | MULE_INTERNAL | ISO_8859_5 |
| mic_to_koi8_r | MULE_INTERNAL | KOI8 |
| mic_to_sjis | MULE_INTERNAL | SJIS |
| mic_to_windows_1250 | MULE_INTERNAL | WIN1250 |
| mic_to_windows_1251 | MULE_INTERNAL | WIN |
| mic_to_windows_866 | MULE_INTERNAL | ALT |
| sjis_to_euc_jp | SJIS | EUC_JP |
| sjis_to_mic | SJIS | MULE_INTERNAL |
| sjis_to_utf_8 | SJIS | UNICODE |
| tcvn_to_utf_8 | TCVN | UNICODE |
| uhc_to_utf_8 | UHC | UNICODE |
| utf_8_to_ascii | UNICODE | SQL_ASCII |
| utf_8_to_big5 | UNICODE | BIG5 |
| utf_8_to_euc_cn | UNICODE | EUC_CN |
| utf_8_to_euc_jp | UNICODE | EUC_JP |
| utf_8_to_euc_kr | UNICODE | EUC_KR |
| utf_8_to_euc_tw | UNICODE | EUC_TW |
| utf_8_to_gb18030 | UNICODE | GB18030 |
| utf_8_to_gbk | UNICODE | GBK |
| utf_8_to_iso_8859_1 | UNICODE | LATIN1 |
| utf_8_to_iso_8859_10 | UNICODE | LATIN6 |
| utf_8_to_iso_8859_13 | UNICODE | LATIN7 |
| utf_8_to_iso_8859_14 | UNICODE | LATIN8 |
| utf_8_to_iso_8859_15 | UNICODE | LATIN9 |
| utf_8_to_iso_8859_16 | UNICODE | LATIN10 |
| utf_8_to_iso_8859_2 | UNICODE | LATIN2 |
| utf_8_to_iso_8859_3 | UNICODE | LATIN3 |
| utf_8_to_iso_8859_4 | UNICODE | LATIN4 |
| utf_8_to_iso_8859_5 | UNICODE | ISO_8859_5 |
| utf_8_to_iso_8859_6 | UNICODE | ISO_8859_6 |
| utf_8_to_iso_8859_7 | UNICODE | ISO_8859_7 |
| utf_8_to_iso_8859_8 | UNICODE | ISO_8859_8 |
| utf_8_to_iso_8859_9 | UNICODE | LATIN5 |
| utf_8_to_johab | UNICODE | JOHAB |
| utf_8_to_koi8_r | UNICODE | KOI8 |
| utf_8_to_sjis | UNICODE | SJIS |
| utf_8_to_tcvn | UNICODE | TCVN |
| utf_8_to_uhc | UNICODE | UHC |
| utf_8_to_windows_1250 | UNICODE | WIN1250 |
| utf_8_to_windows_1251 | UNICODE | WIN |
| utf_8_to_windows_1256 | UNICODE | WIN1256 |
| utf_8_to_windows_866 | UNICODE | ALT |
| utf_8_to_windows_874 | UNICODE | WIN874 |
| windows_1250_to_iso_8859_2 | WIN1250 | LATIN2 |
| windows_1250_to_mic | WIN1250 | MULE_INTERNAL |
| windows_1250_to_utf_8 | WIN1250 | UNICODE |
| windows_1251_to_iso_8859_5 | WIN | ISO_8859_5 |
| windows_1251_to_koi8_r | WIN | KOI8 |
| windows_1251_to_mic | WIN | MULE_INTERNAL |
| windows_1251_to_utf_8 | WIN | UNICODE |
| windows_1251_to_windows_866 | WIN | ALT |
| windows_1256_to_utf_8 | WIN1256 | UNICODE |
| windows_866_to_iso_8859_5 | ALT | ISO_8859_5 |
| windows_866_to_koi8_r | ALT | KOI8 |
| windows_866_to_mic | ALT | MULE_INTERNAL |
| windows_866_to_utf_8 | ALT | UNICODE |
| windows_866_to_windows_1251 | ALT | WIN |
| windows_874_to_utf_8 | WIN874 | UNICODE |
| Remarques : a. Les noms des conversions suivent un schéma de nommage standard : le nom officiel de la source de codage avec tous les caractères non alpha-numériques remplacés par des tirets bas suivis d'un _to_ suivi par le nom de destination du codage après avoir suivi le même traitement que le nom de la source. Du coup, les noms pourraient dévier de noms de codage personnalisés. | ||
| Précédent | Sommaire | Suivant |
| Fonctions et opérateurs mathématiques | Niveau supérieur | Fonctions et opérateurs de chaînes binaires |