Table des matières

Search

  1. Préface
  2. Le langage de transformation
  3. Constantes
  4. Opérateurs
  5. Variables
  6. Dates
  7. Fonctions

Référence du langage de transformation

Référence du langage de transformation

REPLACESTR

REPLACESTR

Remplace des caractères d'une chaîne par un seul, aucun ou plusieurs caractères. REPLACESTR recherche la chaîne d'entrée pour toutes les chaînes que vous indiquez et les remplace par la nouvelle chaîne indiquée.

Syntaxe

REPLACESTR (
CaseFlag
,
InputString
,
OldString
1, [OldString2, ... OldStringN,]
NewString
)
Le tableau suivant décrit les arguments de cette commande:
Argument
Obligatoire/
Facultatif
Description
CaseFlag
Obligatoire
Doit être un nombre entier. Détermine si les arguments de cette fonction sont sensibles à la casse. Vous pouvez entrer l'expression de transformation valide de votre choix.
Si
CaseFlag
est un nombre différent de 0, la fonction est sensible à la casse.
Si
CaseFlag
est une valeur nulle ou 0, la fonction n'est pas sensible à la casse.
InputString
Obligatoire
Doit être une chaîne de caractères. Transmet les chaînes à rechercher. Vous pouvez entrer l'expression de transformation valide de votre choix. Si vous transmettez une valeur numérique, la fonction la convertit en une chaîne de caractères.
Si
InputString
est nulle, REPLACESTR renvoie NULL.
OldString
Obligatoire
Doit être une chaîne de caractères. Chaîne à remplacer. Vous devez entrer au moins un argument
OldString
. Vous pouvez entrer un ou plusieurs caractères par argument
OldString
. Vous pouvez entrer l'expression de transformation valide de votre choix. Vous pouvez également saisir un littéral de texte placé entre guillemets simples, par exemple, 'abc'.
Si vous transmettez une valeur numérique, la fonction la convertit en une chaîne de caractères.
Si REPLACESTR contient plusieurs arguments
OldString
et qu'un ou plusieurs arguments
OldString
sont NULL ou vides, REPLACESTR ignore l'argument
OldString
. Lorsque tous les arguments
OldString
sont nuls ou vides, REPLACESTR renvoie
InputString
.
La fonction remplace les caractères dans les arguments
OldString
dans l'ordre d'apparition dans la fonction. Par exemple, si vous entrez plusieurs arguments
OldString
, le premier argument
OldString
est prioritaire sur le deuxième argument
OldString
et le deuxième argument
OldString
est prioritaire sur le troisième argument
OldString
. Lorsque REPLACESTR remplace une chaîne, il place le curseur après les caractères remplacés dans
InputString
avant de rechercher la correspondance suivante.
NewString
Obligatoire
Doit être une chaîne de caractères. Vous pouvez entrer un ou plusieurs caractères, une chaîne vide, ou NULL. Vous pouvez entrer l'expression de transformation valide de votre choix.
Si
NewString
est NULL ou vide, REPLACESTR supprime toutes les occurrences de
OldString
dans
InputString
.

Valeur de retour

Chaîne.
Chaîne vide si REPLACESTR supprime tous les caractères dans
InputString
.
NULL si
InputString
est NULL.
InputString
si tous les arguments
OldString
sont NULL ou vides.

Exemples

L'expression suivante supprime les guillemets doubles et deux chaînes de texte différentes des données du journal web pour chaque ligne dans le port WEBLOG :
REPLACESTR( 1, WEBLOG, '"', 'GET ', ' HTTP/1.1', NULL )
WEBLOG
RETURN VALUE
"GET /news/index.html HTTP/1.1"
/news/index.html
"GET /companyinfo/index.html HTTP/1.1"
/companyinfo/index.html
GET /companyinfo/index.html
/companyinfo/index.html
GET
[empty string]
NULL
NULL
L'expression modifie le titre de certaines valeurs pour chaque ligne dans le port TITLE :
REPLACESTR ( 1, TITLE, 'rs.', 'iss', 's.' )
TITLE
RETURN VALUE
Mrs.
Ms.
Miss
Ms.
Mr.
Mr.
MRS.
MRS.
L'expression modifie le titre de certaines valeurs pour chaque ligne dans le port TITLE :
REPLACESTR ( 0, TITLE, 'rs.', 'iss', 's.' )
TITLE
RETURN VALUE
Mrs.
Ms.
MRS.
Ms.
L'expression suivante montre comment la fonction REPLACESTR remplace plusieurs arguments
OldString
pour chaque ligne dans le port INPUT :
REPLACESTR ( 1, INPUT, 'ab', 'bc', '*' )
INPUT
RETURN VALUE
abc
*c
abbc
**
abbbbc
*bb*
bc
*
L'expression suivante montre comment la fonction REPLACESTR remplace plusieurs arguments
OldString
pour chaque ligne dans le port INPUT :
REPLACESTR ( 1, INPUT, 'ab', 'bc', 'b' )
INPUT
RETURN VALUE
ab
b
bc
b
abc
bc
abbc
bb
abbcc
bbc
Lorsque vous voulez utiliser un guillemet simple (') dans
OldString
ou
NewString
, vous devez utiliser la fonction CHR. Utilisez les fonctions CHR et CONCAT pour concaténer un guillemet simple dans une chaîne. Le guillemet simple est le seul caractère qui ne peut être utilisé dans un littéral chaîne. Considérons l’exemple suivant :
CONCAT( 'Joan', CONCAT( CHR(39), 's car' ))
La valeur de retour est :
Joan's car
L'expression suivante modifie une chaîne qui comprend le guillemet simple, pour chaque ligne dans le port INPUT :
REPLACESTR ( 1, INPUT, CONCAT('it', CONCAT(CHR(39), 's' )), 'its' )
INPUT
RETURN VALUE
it's
its
mit's
mits
mits
mits
mits'
mits'