Fonction Remplacer

La fonction Replace remplace des caractères par d'autres caractères.

Le remplacement est effectué au niveau de chaque caractère, pas au niveau de la chaîne. Chaque occurrence d'un caractère est remplacée par le caractère de remplacement spécifié, comme illustré dans l'exemple suivant :
  • La liste des caractères à remplacer est 'abc'
  • La liste des caractères de remplacement est 'ABC'
  • La chaîne en entrée est 'aWWWbYYYYcPPPPabc'

La chaîne de résultat est 'AWWWBYYYYCPPPPABC' car le remplacement se fait au niveau des caractères (chaque caractère est remplacé). (Si le remplacement était effectué au niveau de la chaîne, la chaîne de résultat serait 'aWWWbYYYYcPPPPABC'.)

Paramètre : entrée

Chaîne dans laquelle rechercher les caractères à remplacer. La valeur de ce paramètre peut être fournie par un noeud source, le résultat d'une autre fonction ou une valeur que vous indiquez.

Paramètre : fromChars

Liste du ou des caractères à remplacer. Si vous devez remplacer plusieurs caractères, vous devez les indiquer sans les séparer. La valeur de ce paramètre peut être fournie par un noeud source, le résultat d'une autre fonction ou une valeur que vous indiquez.

Paramètre : toChars

Liste du ou des caractères à utiliser pour le remplacement. Répertoriez les caractères de remplacement de ce paramètre dans le même ordre que les caractères à remplacer du paramètre fromChars, car le premier caractère du paramètre fromChars est remplacé par le premier caractère du paramètre toChars, et ainsi de suite. Pour plus d'informations, voir l'exemple 2. La valeur de ce paramètre peut être fournie par un noeud source, le résultat d'une autre fonction ou une valeur que vous indiquez.
Remarque : Vous ne pouvez pas remplacer directement un caractère par une chaîne vide car le paramètre toChars ne peut pas correspondre à une chaîne vide (une chaîne sans caractères). Pour contourner cette règle, voir l'exemple 3.

Renvoie : chaîne

Résultat du remplacement de toutes les occurrences de caractères du deuxième paramètre (fromChars) trouvés dans le premier paramètre (input) par les caractères correspondants du troisième paramètre (toChars).

Exemple 1

Cet exemple montre un remplacement simple d'un caractère par un caractère, comme illustré dans la figure suivante :

Le résultat de l'exécution de cette fonction est la chaîne suivante :

A list of chArActers

Tous les caractères en minuscules sont remplacés par des caractères en majuscules.
Remarque : Dans cet exemple, le paramètre d'entrée est codé en dur sur une valeur spécifique. Généralement, cette valeur est fournie par un noeud source dans une mappe.

Exemple 2

Dans cet exemple, le premier caractère du paramètre fromChars est remplacé par le premier caractère du paramètre toChars, le deuxième caractère du paramètre fromChars est remplacé par le deuxième caractère du paramètre toChars, et ainsi de suite. Le remplacement de plusieurs caractères est illustré dans la figure suivante :

Dans cet exemple, les caractères non numériques (spécifiés à la fin du paramètre fromChars) sont supprimés de la chaîne de numéro de téléphone. Tous les caractères numériques sont remplacés par les mêmes caractères numériques. Par exemple; le caractère 1 est remplacé par le caractère 1. Les autres caractères non numériques à la fin de fromChars, n'ont pas de caractères de remplacement spécifiés dans toChars. Ils sont donc supprimés de la chaîne renvoyée.

Le résultat de l'exécution de cette fonction est la chaîne suivante :

000238882349940
Remarque : Dans cet exemple, le paramètre d'entrée est codé en dur sur une valeur spécifique. Généralement, cette valeur est fournie par un noeud source dans une mappe.

Exemple 3

Cet exemple montre une solution permettant de contourner le fait que vous en pouvez pas remplacer un caractère unique par une chaîne vide. Cette limitation existe car le paramètre toChars ne peut pas être défini sur une chaîne vide (une chaîne sans caractères). Vous pouvez contourner cette limitation en fournissant un caractère factice comme un trait d'union (-) qui ne figure pas dans le paramètre input. Par exemple, vous pouvez spécifier les valeurs suivantes pour les paramètres de la fonction Remplacer comme illustré dans la figure suivante :

Dans cet exemple, le paramètre d'entrée est égal à '1 2 3' (1, espace, 2, espace, 3), le paramètre fromChars est égal à '- ' (trait d'union, espace) et le paramètre toChars est égal à '-' (trait d'union). A l'exécution, la fonction Remplacer avec ces valeurs supprime les espaces du paramètre d'entrée et le résultat de l'exécution est la chaîne suivante :

123

Avertissement : Lorsque vous spécifiez les chaînes dans la zone Valeur de la boîte de dialogue des propriétés de la fonction, n'indiquez pas les apostrophes, uniquement le trait d'union et l'espace.
Remarque : Dans cet exemple, le paramètre d'entrée est codé en dur sur une valeur spécifique. Généralement, cette valeur est fournie par un noeud source dans une mappe.