Opérateurs sur chaînes de caractères

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Utilisation
Notes
L'opérateur [ et ]
L'opérateur [[ et ]]
Égalité souple et égalité très souple
Opérateurs sur les chaînes de caractères et UNICODE
Position dans une chaîne de caractères
Fonctions du WLangage

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

Opérateurs sur chaînes de caractères

Utilisation

Les chaînes de caractères peuvent être manipulées par des fonctions spécifiques du WLangage ou par les opérateurs +, [[ et ]].

Les opérateurs sur des chaînes de caractères sont :

" + " : Pour concaténer des chaînes
" [ " et " ] " : Pour concaténer optionnellement des chaînes
" [[ " et "]]" (double crochets ouvrants et double crochets fermants) : Opérateur d'extraction d'une sous-chaîne
" = " : Égalité stricte
" ~= " : Égalité souple
" ~~ " : Égalité très souple
" [= " : Commence par

Texte est une chaîne = "San Francisco"
Texte[[5]] // Retourne "F"
Texte[[5 A 10]] // Retourne "Franci"
Texte[[5 A]] // Retourne "Francisco"
Texte[[A 10]] // Retourne "San Franci"
Texte[[10 sur 4]] // Retourne "isco"
Texte + " et New York" // Retourne "San Francisco et New York"
SI Texte [= "San" ALORS Trace(Texte)

Notes

L'opérateur [ et ]

L'opérateur [ et ] permet de concaténer optionnellement des chaînes. Le séparateur n'est pas concaténé si la chaîne d'origine est une chaîne vide ("") ou si la chaîne d'origine se termine par le séparateur.

Quelques exemples :

ChaîneDébut += [ChaîneFin]
ChaîneFin se concatène à ChaîneDébut uniquement si ChaîneDébut ne se termine pas par ChaîneFin.
Par exemple :

ChaîneDébut = "San Francisco"
ChaîneFin = "Francisco"
ChaîneDébut += [ChaîneFin]
// ChaîneDébut contient "San Francisco"

ChaîneDébut = "San "
ChaîneFin = "Francisco"
ChaîneDébut += [ChaîneFin]
// ChaîneDébut contient "San Francisco"
ChaîneDébut += [ChaîneMilieu] + ChaîneFin
ChaîneMilieu se concatène à ChaîneDébut uniquement si ChaîneDébut ne se termine pas par ChaîneMilieu et si ChaîneFin ne commence pas par ChaîneMilieu. Le séparateur n'est pas concaténé si la chaîne d'origine est une chaîne vide ("").
Par exemple :

ChaîneDébut = "C:\MesFichiers\"
ChaîneMilieu = "\"
ChaîneFin = "MonFichier.TXT"
ChaîneDébut += [ChaîneMilieu] + ChaîneFin
// ChaîneDébut contient "C:\MesFichiers\MonFichier.TXT"

ChaîneDébut = "C:\MesFichiers"
ChaîneMilieu = "\"
ChaîneFin = "\MonFichier.TXT"
ChaîneDébut += [ChaîneMilieu] + ChaîneFin
// ChaîneDébut contient "C:\MesFichiers\MonFichier.TXT"

ChaîneDébut = "C:\MesFichiers"
ChaîneMilieu = "\"
ChaîneFin = "MonFichier.TXT"
ChaîneDébut += [ChaîneMilieu] + ChaîneFin
// ChaîneDébut contient "C:\MesFichiers\MonFichier.TXT"
MaChaîne = [ChaîneDébut] + ChaîneFin
ChaîneDébut se concatène à ChaîneFin uniquement si ChaîneFin ne commence pas par ChaîneDébut.
Par exemple :

ChaîneDébut = "Tome"
ChaîneFin = "Tome de programmation"
MaChaîne = [ChaîneDébut] + ChaîneFin
// ChaîneDébut contient "Tome de programmation"

ChaîneDébut = "Tome"
ChaîneFin = " de programmation"
MaChaîne = [ChaîneDébut] + ChaîneFin
// ChaîneDébut contient "Tome de programmation"

Exemples :

Remplissage d'une chaîne avec des éléments séparés par des RC (Retour Chariot). Le séparateur n'est pas concaténé si la chaîne d'origine est une chaîne vide.

ChaîneRes est une chaîne
POUR TOUT Client
ChaîneRes += [RC] + Client.Nom
FIN
Création d'un chemin de fichier sans se soucier des caractères "\" absents ou présents.

fOuvre(NomRépertoire + ["\"] + NomFichier)

Liste des exemples associés :

Exemples unitaires (WINDEV) : La concaténation optionnelle

[ + ] Utilisation de la concaténation optionnelle de chaîne.
La concaténation optionnelle permet d'ajouter une chaîne de caractères à la fin d'une autre seulement si elle n'existe pas déjà.

L'opérateur [[ et ]]

L'opérateur [[ et ]] permet d'extraire et de remplacer une sous-chaîne.

Quelques exemples :

CHAINEAEXTRAIRE[[<Position>]]
CHAINEAEXTRAIRE[[<Position>]] = <Nouvelle chaîne> : Remplace le caractère de la chaîne par la nouvelle chaîne.
CHAINEAEXTRAIRE[[<Début> à <Fin>]]
CHAINEAEXTRAIRE[[<Début> à]]
CHAINEAEXTRAIRE[[à <Fin>]]
CHAINEAEXTRAIRE[[<Début> sur <Nombre>]]

Attention : Si vous utilisez une procédure manipulant les chaînes avec les opérateurs [[]], méfiez-vous de la syntaxe utilisée. Vous pouvez sans le vouloir modifier vos chaînes de caractères.
Par exemple, la procédure suivante peut entraîner la modification d'une partie de la chaîne.

PROCEDURE P(sChaîne)
SI sChaîne ALORS sChaîne="5"
// -- Appel de la procédure par la ligne :
p(sVar[[3 A]])

Pour éviter toute modification de la chaîne initiale, il est nécessaire de passer le paramètre par valeur :

soit en utilisant des parenthèses autour du paramètre dans l'appel de la procédure,
soit en utilisant le mot-clé Local dans l'entête de la procédure.

Différence avec WINDEV 7.5 :

WINDEV : L'opérateur [[]] utilisé avec une valeur négative en seconde borne renvoie une chaîne vide ("").
WINDEV 7.5 : L'opérateur [[]] utilisé avec une valeur négative en seconde borne renvoie la chaîne complète.

Exemple : Parcours d'une chaîne de caractères, caractère par caractère : SAI_HTML et SAI_TEXTE sont 2 champs de saisie.

// Variables
sChaîne est une chaîne = SAI_HTML
sCaract est une chaîne
i est un entier = 1
// Parcours du champ HTML
sCaract = sChaîne[[i A i]]
TANTQUE i <= Taille(sChaîne)
i++
// ICI traitement sur sCaract
// Caractères suivants
sCaract = sChaîne[[i A i]]
FIN

Égalité souple et égalité très souple

L'égalité souple (~=) et l'égalité très souple (~~) agissent uniquement sur les chaînes de caractères (sauf les chaînes fixes). Ces opérateurs permettent de :

ne pas différencier les caractères majuscules des caractères minuscules,
ne pas tenir compte des espaces situés avant et après la chaîne à tester,
ne pas tenir compte des caractères accentués minuscules,
ne pas tenir compte des espaces et des ponctuations à l'intérieur des chaînes (égalité très souple uniquement).

Équivalence HFSQL : Pour retrouver l'équivalence à l'égalité très souple lors d'une recherche sur une clé texte dans un fichier HFSQL, il est nécessaire de configurer les options suivantes lors de la description de la rubrique dans l'analyse :

Opérateurs sur les chaînes de caractères et UNICODE

Les opérateurs disponibles sont :

" + " : Pour concaténer des chaînes
" [ " et " ] " : Pour concaténer optionnellement des chaînes
" [[ " et " ]] " (double crochets ouvrants et double crochets fermants) : Opérateur d'extraction d'une sous-chaîne
" [= " : Commence par

Opérateur "+", "[" et "]"
Il est possible de concaténer deux chaînes UNICODE. Il n'est pas possible de concaténer une chaîne UNICODE et une chaîne ANSI.
Remarque : Si la concaténation de deux chaînes AINSI est affectée à une chaîne UNICODE (et inversement), la conversion sera implicitement réalisée.

Opérateur "[[" et "]]"
Toutes les syntaxes de l'opérateur [[]] sont disponibles sur les chaînes UNICODE.

Si la chaîne passée en paramètre est au format ANSI, l'opérateur [[]] renvoie le résultat au format ANSI.
Si la chaîne passée en paramètre est au format UNICODE, l'opérateur [[]] renvoie le résultat au format UNICODE.
Les paramètres de position et de longueur sont donnés en nombre de caractères.

Remarque : Si le résultat de l'opérateur [[]] sur une chaîne ANSI est affecté à une chaîne UNICODE (et inversement), la conversion sera implicitement réalisée.

Position dans une chaîne de caractères

Le premier caractère est en position 1 (et non en position 0).
La fonction Position retourne la position de départ d'une chaîne de caractères donnée à l'intérieur d'une autre chaîne de caractères.

Fonctions du WLangage

Les chaînes de caractères peuvent également être manipulées grâce aux fonctions :

Remarque : les opérateurs [[]] sont dans la plupart des cas plus performants que les fonctions WLangage.

Liste des exemples associés :