DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des chaînes
  • Fonction <Type Chaîne>.Remplace et UNICODE
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Remplace toutes les occurrences d'un mot présent dans une chaîne par un autre mot.
Remarque : La chaîne de caractères initiale n'est pas modifiée.
Exemple
ChaîneInitiale est une chaîne = "Abracadabra !"
ChaîneRemplacée est une chaîne = ChaîneInitiale.Remplace("a", "o")
Info(ChaîneRemplacée) // Affiche "Abrocodobro !"
WINDEVWEBDEV - Code ServeurUniversal Windows 10 AppiPhone/iPadWidget IOSApple WatchMac Catalyst
ChaîneInitiale est une chaîne = "betterave // abricot // fraise / melon \ noix / citron"
ChaîneRemplacée est une chaîne = ChaîneInitiale.Remplace(["//", "/", "\", "\\"], "-")
Trace(ChaîneRemplacée) // Affiche "betterave - abricot - fraise - melon - noix - citron"
 
 
tabMonTableau est un tableau de 4 chaînes
tabMonTableau[1] = "//"
tabMonTableau[2] = "/"
tabMonTableau[3] ="\"
tabMonTableau[4] = "\\"
ChaîneRemplacée = ChaîneInitiale.Remplace(tabMonTableau, "-")
Trace(ChaîneRemplacée) // Affiche "betterave - abricot - fraise - melon - noix - citron"
WINDEVWEBDEV - Code ServeurUniversal Windows 10 AppiPhone/iPadWidget IOSApple WatchMac Catalyst
ChaîneInitiale est une chaîne = "betterave // abricot // fraise / melon \ noix / citron"
ChaîneRemplacée est une chaîne = ChaîneInitiale.Remplace(["//", "/", "\", "\\"], "-")
Trace(ChaîneRemplacée) // Affiche "betterave - abricot - fraise - melon - noix - citron"
 
 
tabMonTableau est un tableau de 4 chaînes
tabMonTableau[1] = "//"
tabMonTableau[2] = "/"
tabMonTableau[3] ="\"
tabMonTableau[4] = "\\"
ChaîneRemplacée = ChaîneInitiale.Remplace(tabMonTableau, "-")
Trace(ChaîneRemplacée) // Affiche "betterave - abricot - fraise - melon - noix - citron"
Syntaxe

Remplacer une chaîne par une autre Masquer les détails

<Résultat> = <Chaîne initiale>.Remplace(<Chaîne à remplacer> , <Nouvelle chaîne> [, <Option>])
<Résultat> : Chaîne de caractères
Nouvelle chaîne de caractères dans laquelle les différents remplacements ont été effectués.
<Chaîne initiale> : Chaîne de caractères
Chaîne de caractères dans laquelle les remplacements doivent être effectués (taille maximale : 2 Go).
<Chaîne à remplacer> : Chaîne de caractères
Chaîne de caractères à remplacer dans la chaîne initiale.
Si ce paramètre correspond à une chaîne vide (""), <Résultat> correspondra à <Chaîne initiale>.
<Nouvelle chaîne> : Chaîne de caractères
Chaîne de caractères qui remplacera <Chaîne à remplacer>.
Si ce paramètre correspond à une chaîne vide (""), toutes les occurrences de <Chaîne à remplacer> seront supprimées.
<Option> : Constante (ou combinaison de constantes) optionnelle
Indique les caractéristiques de la recherche du mot à remplacer :
MotCompletRecherche le mot complet (entouré par des caractères de ponctuation ou des espaces)
SansCasseRecherche sans tenir compte de la casse (majuscules/minuscules) et des accents.

Par défaut, la recherche est sensible à la casse : la chaîne recherchée doit avoir la même casse que la chaîne à trouver dans la chaîne initiale. Pour effectuer une recherche ne tenant pas compte de la casse, utilisez la constante SansCasse.
WEBDEV - Code Navigateur Ce paramètre n'est pas disponible. La recherche est sensible à la casse. La chaîne à remplacer ne correspond pas obligatoirement à un mot complet : cette chaîne peut correspondre à une partie d'un mot.
WINDEVWEBDEV - Code ServeurUniversal Windows 10 AppiPhone/iPadWidget IOSApple WatchMac Catalyst

Remplacer un ensemble de chaînes par une nouvelle chaîne Masquer les détails

<Résultat> = <Chaîne initiale>.Remplace(<Tableau des chaînes à remplacer> , <Nouvelle chaîne> [, <Option>])
<Résultat> : Chaîne de caractères
Nouvelle chaîne de caractères dans laquelle les différents remplacements ont été effectués.
<Chaîne initiale> : Chaîne de caractères
Chaîne de caractères dans laquelle les remplacements doivent être effectués (taille maximale : 2 Go).
<Tableau des chaînes à remplacer> : Tableau
Tableau des chaînes à remplacer dans la <Chaîne initiale>. Ce tableau peut correspondre :
  • à une variable de type Tableau.
  • à un tableau exprimé sous la forme : [Valeur1, Valeur2, ... , Valeur N].
Si ce paramètre correspond à une chaîne vide (""), <Résultat> correspondra à <Chaîne initiale>.
<Nouvelle chaîne> : Chaîne de caractères
Chaîne de caractères qui remplacera toutes les chaînes spécifiées dans <Tableau des chaînes à remplacer>.
Si ce paramètre correspond à une chaîne vide (""), toutes les occurrences de <Chaîne à remplacer> seront supprimées.
<Option> : Constante (ou combinaison de constantes) optionnelle
Indique les caractéristiques de la recherche des mots à remplacer :
MotCompletRecherche le mot complet (entouré par des caractères de ponctuation ou des espaces)
SansCasseRecherche sans tenir compte de la casse (majuscules/minuscules) et des accents.

Par défaut, la recherche est sensible à la casse : la chaîne recherchée doit avoir la même casse que la chaîne à trouver dans la chaîne initiale. Pour effectuer une recherche ne tenant pas compte de la casse, utilisez la constante SansCasse.
WINDEVWEBDEV - Code ServeurUniversal Windows 10 AppiPhone/iPadWidget IOSApple WatchMac Catalyst

Remplacer une portion de chaîne par une nouvelle chaîne Masquer les détails

<Résultat> = <Chaîne initiale>.Remplace(<Position> , <Longueur> , <Nouvelle chaîne>)
<Résultat> : Chaîne de caractères
Nouvelle chaîne de caractères dans laquelle le remplacement a été effectué.
<Chaîne initiale> : Chaîne de caractères
Chaîne de caractères dans laquelle le remplacement doit être effectué (taille maximale : 2 Go).
<Position> : Entier
Position de la portion de chaîne à remplacer.
<Longueur> : Entier
Longueur de la portion de chaîne à remplacer.
<Nouvelle chaîne> : Chaîne de caractères
Chaîne de caractères qui remplacera la portion de chaîne spécifiée.
Remarques

Fonction <Type Chaîne>.Remplace et UNICODE

Les paramètres <Chaîne initiale>, <Chaîne à remplacer> et <Nouvelle chaîne> peuvent correspondre tous les trois :
  • soit à des chaînes ANSI.
  • soit à des chaînes UNICODE.
  • soit à des buffers.
Il est possible d'utiliser des chaînes ANSI, Unicode et des buffers dans les différents paramètres de la fonction.
La règle de conversion utilisée est la suivante pour les systèmes Ansi (Windows ou Linux) :
  • Si l'une au moins des chaînes est un buffer, toutes les chaînes sont converties en buffer, et l'opération est réalisée avec des buffers.
  • Si la première condition n'est pas remplie, si l'une au moins des chaînes est Unicode, toutes les chaînes sont converties en Unicode et l'opération est réalisée en Unicode (si nécessaire, la conversion est réalisée avec l'alphabet courant).
  • Sinon, l'opération est réalisée en Ansi.
La règle de conversion utilisée est la suivante pour les systèmes Unicode :
  • Si l'une au moins des chaînes est un buffer, toutes les chaînes sont converties en buffers et l'opération est réalisée avec des buffers.
  • Sinon, l'opération est réalisée en Unicode.
Pour plus de détails sur l'UNICODE, consultez Gestion de l'UNICODE.
Rappel : Les paramètres linguistiques utilisés sont définis lors de l'appel de la fonction ChangeAlphabet.
Composante : wd290vm.dll
Version minimum requise
  • Version 24
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 19/06/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale