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 : If( "aab" ~= "a+" , "true", "false" ) Case when "aba" ~= ".a+$" then "true" else "false" end |
| 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 : Concatenate("April ", 20+1, "st") → "April 21st" Concatenate(null, "Ape") → "Ape" Concatenate (null, null) → (Vide) |
| 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 Arg1 est une chaîne manquante, 0 est renvoyé. Exemples : Find("lo", "Hello") → 4 Find("a", "Hello") → 0 Find("", "Hello") → 0 Find("", null) → (Vide) If(Find("Pri 1", [Col1])>0, "Important", "Not important") Find("a", "ababab") → 1 Find("a", "ababab", 2) → 3 Find("a", "ababab", 10) → 0 |
| Left(Arg1, Arg2) | Renvoie les Arg2 premiers caractères de la chaîne Arg1. Arg1 et le résultat sont de type chaîne. Arg2 est de type réel, toutefois seul le nombre entier est utilisé. Si Arg2 > la longueur de Arg1, l'intégralité de la chaîne est renvoyée. Si Arg2 est négatif, alors le nombre Arg2 de caractères sera supprimé à droite de la chaîne Arg1. Exemples : Left("Daddy", 1) → "D" Left("Daddy", 3.99) → "Dad" Left("Daddy", 386) → "Daddy" Left("Daddy", -1) → "Dadd" |
| Len(Arg1) | Renvoie la longueur d'Arg1. Arg1 est de type chaîne et le résultat est de type entier. Exemples : Len("Hello") → 5 Len(null) → (Vide) |
| Lower(Arg1) | Renvoie Arg1 converti en minuscules. Arg1 et le résultat sont de type chaîne. |
| Mid(Arg1, Arg2, Arg3) | Renvoie la sous-chaîne d'Arg1 commençant à l'index Arg2 et dont la taille est de Arg3 caractères. Arg1 et le résultat sont de type chaîne. Arg2 et Arg3 sont du type réel, toutefois seule la partie entière est utilisée. Si Arg2 > 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 : Mid("Daddy", 2, 3) → "add" Mid("Daddy", 386, 4) → "" Mid("Daddy", 4, 386) → "dy" Mid("Daddy", -1, 2) → (Vide) Mid("Daddy", 2, -1) → (Vide) |
| 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 : MostCommon([Column]) |
| NameDecode(Arg1) | Remplace tous les codes de sous-chaînes par des caractères décodés. Les noms de colonnes dans TIBCO Spotfire® sont stockés sous la forme de chaînes codées en UTF-16. Exemple : NameDecode("Column %02D") |
| 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 TIBCO Spotfire® sont stockés sous la forme de chaînes codées en UTF-16. Exemple : NameEncode("Column £") |
| Repeat | Répète une chaîne autant de fois qu’indiqué. Exemple : Repeat("Hello", 2) → "HelloHello" |
| Right(Arg1, Arg2) | Renvoie les Arg2 derniers caractères de la chaîne Arg1. Arg1 et le résultat sont de type chaîne. Arg2 est de type réel, toutefois seul le nombre entier est utilisé. Si Arg2 > la longueur de Arg1, l'intégralité de la chaîne est renvoyée. Si Arg2 est négatif, alors le nombre Arg2 de caractères sera supprimé à gauche de la chaîne Arg1. Exemples : Right("Daddy", 1) → "y" Right("Daddy", 3.99) → "ddy" Right("Daddy", 386) → "Daddy" Right("Daddy", -1) → "addy" |
| RXExtract(Arg1, Arg2, Arg3) |
Renvoie la partie d'une chaîne (Arg1) qui correspond à l'expression régulière (Arg2). Arg3 détermine la correspondance à utiliser lorsqu'il y a plusieurs correspondances. Exemples : RXExtract([Column], "l+", 1) RXExtract("Parallel", "l+", 1) → "ll" RXExtract("Parallel", "l+", 2) → "l" |
| 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. Arg4 définit les options du remplacement : « g » indique que si Arg2 a plusieurs correspondances, toutes les correspondances doivent être remplacées. « i » indique que la comparaison ne doit pas tenir compte de la casse. Dans le mode à ligne simple, « s » indique que le point (.) correspond à n'importe quel caractère (pas n'importe quel caractère sauf le caractère de retour à la 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 : RXReplace("Hello", "L+", "LL", "i") → "HeLLo" RXReplace("3 Minor", "(\\d).*", "$1", "") → 3 RXReplace([Column with values within parenteses], "\\(89\\)", "", "") RXReplace("change\\slashdirection","\\\\","/","") → change/slashdirection (Dans le dernier exemple, la barre oblique 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 values 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 Arg3 négatif pour spécifier que la division doit être effectuée de la fin de la chaîne vers le début, au lieu du début vers la fin. Par exemple, si une colonne appelée « X » contenant la valeur « a.b » est divisée en deux parties à l'aide du séparateur « . », alors Split([X],".",1) renvoie « a » et Split([X],".",2) renvoie « b ». Exemples : Split([Column]," ",2) Split([Column]," ",-2) Split([Column]," / ",3) |
| Substitute(Arg1, Arg2, Arg3) | Remplace toutes les occurrences de Arg2 dans Arg1 par Arg3. La recherche est sensible à la casse. Exemple : Substitute("Test","t","ting") → "Testing" |
| Substring(Arg1, Arg2, Arg3) | Renvoie la sous-chaîne d'Arg1 commençant à l'index Arg2 et dont la taille est de Arg3 caractères. Arg1 et le résultat sont de type chaîne. Arg2 et Arg3 sont du type réel, toutefois seule la partie entière est utilisée. Si Arg2 > 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 : Substring("Daddy", 2, 3) → "add" Substring("Daddy", 386, 4) → "" Substring("Daddy", 4, 386) → "dy" Substring("Daddy", -1, 2) → (Vide) Substring("Daddy", 2, -1) → (Vide) |
| Trim(Arg1) | Supprime les espaces au début et à la fin d'une chaîne. Exemple : Trim(" Example ") → "Example" |
| UniqueConcatenate(Arg1) | Concatène les valeurs uniques converties en chaînes. Les valeurs sont classées selon le comparateur. Exemple : UniqueConcatenate([Column]) |
| Upper(Arg1) | Renvoie Arg1 converti en majuscules. Arg1 et le résultat sont de type chaîne. Exemple : Upper("hello") → "HELLO" |