Fonctions textuelles
La liste indique les fonctions textuelles pouvant être utilisées dans des expressions.
| Fonction | Description |
|---|---|
~=
|
Peut faire partie d'une instruction If ou Case. Renvoie true si la chaîne de l'expression régulière Arg2 correspond à la chaîne Arg1. Exemples :
|
Concatenate(Arg1, ...)
|
Concatène (intègre) tous les arguments dans une chaîne. Si un argument est donné, le résultat représente la concaténation de toutes les lignes. Si plusieurs arguments sont donnés, chaque ligne est concaténée. Les arguments peuvent être de type quelconque mais sont convertis en chaînes. Le résultat est de type chaîne. Les arguments null sont ignorés. Exemples :
|
Find(Arg1, Arg2, Arg3)
|
Renvoie l'index de l'occurrence de la chaîne Arg1 dans Arg2. Arg3 indique éventuellement la correspondance à renvoyer. Si aucun troisième argument n'est donné, la première correspondance est renvoyée. Si aucune correspondance n'est trouvée, la valeur 0 est renvoyée. La recherche est sensible à la casse. Les deux premiers arguments sont de type chaîne et le résultat ainsi que le troisième argument sont de type entier. Si Exemples :
|
Left(Arg1, Arg2)
|
Renvoie les Arg2 premiers caractères de la chaîne Arg1. Arg1 et le résultat sont de type String. Arg2 est de type Real, toutefois seule la valeur Integer est utilisée. Si Arg2 est > à la longueur de Arg1, l'intégralité de la chaîne est renvoyée. Si Arg2 est négatif, le nombre de caractères Arg2 sera supprimé à droite de la chaîne Arg1. Exemples :
|
Len(Arg1)
|
Renvoie la longueur de Arg1. Arg1 est de type String et le résultat est de type Integer. Exemples :
|
Lower(Arg1)
|
Renvoie Arg1 converti en minuscules. Arg1 et le résultat sont de type String.
|
Mid(Arg1, Arg2, Arg3)
|
Renvoie la sous-chaîne de Arg1 commençant à l'index Arg2 et dont la taille est de Arg3 caractères. Arg1 et le résultat sont de type String. Arg2 et Arg3 sont du type Real, toutefois seule la valeur Integer est utilisée. Si Arg2 est > à Len(Arg1), une chaîne vide est renvoyée. De même, si Arg2+Arg3 > Len(Arg1), Arg3 est ajusté à 1+Len(Arg1)-Arg2. Si Arg2 ou Arg3 est négatif ou si Arg2 est égal à zéro, une erreur est renvoyée. Exemples :
|
MostCommon(Arg1)
|
Retourne la valeur la plus commune de la colonne spécifiée. Si plusieurs valeurs sont uniformément communes, la première sera utilisée. Exemple :
|
NameDecode(Arg1)
|
Remplace tous les codes de sous-chaînes par des caractères décodés. Les noms de colonnes dans Spotfire sont stockés sous la forme de chaînes codées en UTF-16. Exemple :
|
NameEncode(Arg1)
|
Code les caractères de la chaîne, de sorte qu’elle ne contienne que des caractères correspondant à l’expression régulière [.0-9a-zA-Z]. Les noms de colonnes dans Spotfire sont stockés sous la forme de chaînes codées en UTF-16. Exemple :
|
Repeat
|
Répète une chaîne autant de fois qu’indiqué. Exemple :
|
Right(Arg1, Arg2)
|
Renvoie les Arg2 derniers caractères de la chaîne Arg1. Arg1 et le résultat sont de type String. Arg2 est de type Real, toutefois seule la valeur Integer est utilisée. Si Arg2 > la longueur de Arg1, l'intégralité de la chaîne est renvoyée. Si Exemples :
|
RXExtract(Arg1, Arg2, Arg3)
|
Renvoie la partie d'une chaîne ( Exemples :
|
RXReplace(Arg1, Arg2, Arg3, Arg4)
|
Remplace une sous-chaîne selon une expression régulière. Recherche l'expression régulière Arg2 dans Arg1 et la remplace par Arg3.
"g" spécifie que si "i" spécifie que la comparaison doit être insensible à la casse. "s", pour le mode ligne unique, spécifie que le point (.) correspond à chaque caractère (au lieu de chaque caractère sauf la nouvelle ligne). Certains caractères, tels que la barre oblique inverse « \ » et les parenthèses « ( » et « ) » doivent être protégés pour fonctionner dans les colonnes calculées. Étant donné que les parenthèses sont utilisées pour effectuer des regroupements dans les expressions régulières, elles doivent être protégées si le signe « ( » ou « ) » doit être mis en correspondance. Lorsque ce caractère est utilisé dans une expression régulière, une double barre oblique inverse est nécessaire pour protéger à la fois la chaîne Spotfire et l'expression régulière. Pour plus d'informations sur le langage des expressions régulières, reportez-vous à la documentation en ligne, par exemple MSDN. Exemples :
(Dans le dernier exemple, la barre oblique inverse doit être protégée deux fois ; une fois pour la chaîne Spotfire et une fois pour l'expression régulière.) |
Split(Arg1, Arg2, Arg3)
|
Divise les valeurs dans Arg1 en un nombre de sous-chaînes, en utilisant Arg2 comme séparateur. Arg3 spécifie les valeurs qui doivent être renvoyées dans une nouvelle colonne. Une seule colonne est renvoyée. Utilisez un Par exemple, si une colonne appelée « X » contenant la valeur « Exemples :
|
Substitute(Arg1, Arg2, Arg3)
|
Remplace toutes les occurrences de Arg2 dans Arg1 par Arg3. La recherche est sensible à la casse. Exemple :
|
Substring(Arg1, Arg2, Arg3)
|
Renvoie la sous-chaîne de Arg1 commençant à l'index Arg2 et dont la taille est de Arg3 caractères. Arg1 et le résultat sont de type String. Arg2 et Arg3 sont du type Real, toutefois seule la valeur Integer est utilisée. Si Arg2 est > à Len(Arg1), une chaîne vide est renvoyée. De même, si Arg2 + Arg3 > Len(Arg1), Arg3 est ajusté à 1+Len(Arg1) - Arg2. Si Arg2 ou Arg3 est négatif ou si Arg2 est égal à zéro, une erreur est renvoyée. Exemples :
|
Trim(Arg1)
|
Supprime les espaces au début et à la fin d'une chaîne. Exemple :
|
UniqueConcatenate(Arg1)
|
Concatène les valeurs uniques converties en chaînes. Les valeurs sont classées selon le comparateur. Exemple :
|
Upper(Arg1)
|
Renvoie Arg1 converti en majuscules. Arg1 et le résultat sont de type String. Exemple :
|