Fonctions de texte

Les fonctions de texte sont disponibles dans le menu Fonction de texte. Elles s'appliquent aux propriétés de texte et sont utiles pour formater les résultats des requêtes liées au texte. Ces fonctions sont disponibles pour chaque fournisseur de données, à l'exception des fournisseurs raster, WFS et WMS.

Lorsque vous créez une expression pour des objets géospatiaux, vous pouvez faire appel aux fonctions de texte suivantes :

Fonction	Définition	Syntaxe	Exemple
CONCAT	Joint plusieurs chaînes en une seule. CONCAT prend un nombre indéfini d'arguments, qui peuvent être n'importe quel type de propriété, à l'exception de propriétés de géométrie ou de raster. La valeur renvoyée fait appel au type de données Chaîne. Utilisez '\n' pour insérer un retour à la ligne lorsque vous utilisez des styles standard. Utilisez '\P' pour insérer un saut de ligne lorsque vous utilisez des styles améliorés. Ces paramètres sont sensibles à la casse. Pour inclure des étiquettes ou des espaces au texte statique, entourez-les de guillemets simples. Lorsque vous utilisez Concat avec une propriété booléenne, l'opération génère 1/0 (et non vrai/faux).	CONCAT(Propriété, Propriété, ...)	CONCAT(Prénom, ' 'Nom, '\n' 'Adresse : ', Numéro_rue, ' ', Nom_rue, ' ', Suffixe) Cet exemple vous permet de créer l'étiquette suivante : Jean Dupont Adresse : 123 rue des Erables
INSTR	Trouve la position de la première occurrence d'une sous-chaîne dans une autre chaîne. Spécifie la chaîne source en tant que premier argument et la chaîne que vous recherchez comme second argument. Renvoie un entier avec le type de données Int64.	INSTR(Propriété ou valeur du texte, Propriété ou valeur du texte)	INSTR(Propriétaire_parcelle,'champ) Cet exemple recherche la sous-chaîne "champ" dans la chaîne du propriétaire de la parcelle. Si le nom du propriétaire de la parcelle est Smithfield, la valeur renvoyée est 6.
LENGTH	Renvoie le nombre de caractères dans la chaîne spécifiée sous la forme d'un entier du type de données Int64. N'inclut pas de caractères de fin vides.	LENGTH(Propriété_texte)	LENGTH(Prénom) Cet exemple trouve le nombre de caractères dans la propriété de prénom.
LOWER	Convertit le texte en minuscules. La valeur renvoyée fait appel au type de données Chaîne.	LOWER(Propriété_texte)	LOWER(Nom_produit) Cet exemple change un nom de produit en minuscules (par exemple, CANALISATIONS en canalisations).
LPAD	Complète le côté gauche d'une chaîne avec les caractères spécifiés. La valeur renvoyée fait appel au type de données Chaîne. LPAD peut prendre deux ou trois paramètres. Si vous ne spécifiez pas l'argument de caractère de texte, un caractère d'espacement est utilisé.	LPAD(Propriété_texte, Nombre de caractères,'caractère de texte')	LPAD(Priorité_élevée,3,'*') Cet exemple affiche une valeur pour la propriété Priorité_élevée (par exemple, "réparation d'urgence") précédée de ***.
LTRIM	Ajuste les caractères d'une chaîne de texte à partir du côté gauche. La valeur renvoyée fait appel au type de données Chaîne.	LTRIM(Propriété_texte)	LTRIM(ID_parcelle) Cet exemple supprime les caractères de fin des identificateurs de parcelle.
RPAD	Complète le côté droit d'une chaîne avec les caractères spécifiés. La valeur renvoyée fait appel au type de données Chaîne. RPAD peut prendre deux ou trois paramètres. Si vous ne spécifiez pas l'argument de caractère de texte, un caractère d'espacement est utilisé.	RPAD(Propriété_texte, Nombre de caractères,'caractère de texte')	RPAD(Réparation_coûteuse,3,$) Cet exemple présente une valeur pour la propriété Réparation_coûteuse (par exemple, "remaniement complet") suivie de $$$$.
RTRIM	Ajuste les caractères d'une chaîne de texte à partir du côté droit (caractères de fin). La valeur renvoyée fait appel au type de données Chaîne. Pour supprimer des caractères de fin, faites appel à TRIM. Voir TRIM.	RTRIM(Propriété_texte)	RTRIM(ID_parcelle) Cet exemple supprime les caractères qui suivent des identifiants de parcelles.
SOUNDEX	Renvoie des noms qui ressemblent phonétiquement (en anglais) à la chaîne de texte spécifiée. La valeur renvoyée fait appel au type de données Chaîne. Le SGBD sous-jacent évalue les expressions incluant la fonction SOUNDEX. Cependant, le résultat renvoyé par un fournisseur MySQL peut différer du résultat obtenu d'autres fournisseurs.	SOUNDEX(Propriété_texte) = SOUNDEX('chaîne de texte')	SOUNDEX(Prénom) = SOUNDEX('Smith') Cet exemple trouve des noms ressemblant phonétiquement à Smith (par exemple, "Smythe").
SUBSTR	Extrait une sous-chaîne d'une chaîne. Si la position de départ est 0, elle est traitée comme étant 1. Si vous spécifiez une valeur négative pour cette position, l'expression compte à rebours depuis la fin de la chaîne. La valeur renvoyée fait appel au type de données Chaîne. Par exemple, SUBSTR('ABCDEFG',-6,4) trouve BCDE.	SUBSTR(Propriété_chaîne, Position de départ, Longueur de la sous-chaîne)	SUBSTR(Nom,0,4)
TRANSLATE	Remplace une séquence de caractères par un autre jeu de caractères. La valeur renvoyée fait appel au type de données Chaîne. Par exemple, TRANSLATE('Le guide du spécialiste des SIG pour C#' ' ''#', '___') transforme le titre du manuel en "Le_guide_du_spécialiste_des_SIG pour_C_)". Le titre original nécessitait un guillemet simple supplémentaire comme caractère d'échappement.	TRANSLATE(Propriété_texte,'texte-début','texte-fin')	TRANSLATE(Propriété_commentaire ' ''#', '___') Cet exemple transforme les espaces, guillemets et dièses (#) en traits de soulignement.
TRIM	Ajuste les caractères de tête d'une chaîne de texte. Pour supprimer les caractères de fin, faites appel à RTRIM. La valeur renvoyée fait appel au type de données Chaîne. Vous pouvez spécifier un argument facultatif : BOTH, LEADING ou TRAILING. Si vous ne précisez pas le caractère d'ajustement, un espace blanc est adopté par défaut. Voir RTRIM.	TRIM('argument_facultatif', Propriété_texte)	TRIM('fin', ID_parcelle) Cet exemple ajuste les caractères de fin de l'ID de parcelle.
UPPER	Convertit le texte en majuscules. La valeur renvoyée fait appel au type de données Chaîne.	UPPER(Propriété_texte)	UPPER(Propriétaire_parcelle) Cet exemple affiche la valeur "Jean Delatour" sous la forme "JEAN DELATOUR".