Funções de texto
A lista mostra as funções de texto que você pode usar em expressões.
| Função | Descrição |
|---|---|
| ~= | Pode ser parte de uma instrução If ou Case. Retornará true se os caracteres de expressão regular do Arg2 corresponderem aos caracteres do Arg1. Exemplos: If( "aab" ~= "a+" , "true", "false" ) Case when "aba" ~= ".a+$" then "true" else "false" end |
| Concatenate(Arg1, ...) | Concatena (anexa) todos os argumentos em caracteres. Se um argumentos é dado, então o resultado é a concatenação de todas as linhas. Se mais de um argumento é dado, então cada linha é concatenada. Os argumentos podem ser de qualquer tipo, mas são convertidos em caracteres. O resultado é do tipo caracteres. Argumentos nulos são ignorados. Exemplos: Concatenate("April ", 20+1, "st") → "April 21st" Concatenate(null, "Ape")→ "Ape" Concatenate (null, null) → (Vazio) |
| Find(Arg1, Arg2, Arg3) | Retorna o índice de ocorrência dos caracteres Arg1 em Arg2. Arg3 indica opcionalmente qual correspondência retornar. Se não for fornecido um terceiro argumento, a primeira correspondência será retornada. Se nenhuma correspondência for encontrada, será retornado 0. A pesquisa é sensível a maiúsculas. Os dois primeiros argumentos são do tipo caracteres e o terceiro argumento e o resultado são do tipo inteiro. Se o Arg1 forem os caracteres vazios, 0 será retornado. Exemplos: Find("lo", "Hello") → 4 Find("a", "Hello") → 0 Find("", "Hello") → 0 Find("", null) → (Vazio) 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) | Retorna os primeiros caracteres Arg2 dos caracteres Arg1. Arg1 e o resultado são do tipo string. Arg2 é do tipo real, mas somente a parte inteira é utilizada. Se Arg2> que o comprimento do Arg1, todos os caracteres serão retornados. Se Arg2 for negativo, o número de caracteres Arg2 será removido do lado direito da sequência de caracteres Arg1. Exemplos: Left("Daddy", 1) → "D" Left("Daddy", 3.99) → "Dad" Left("Daddy", 386) → "Daddy" Left("Daddy", -1) → "Dadd" |
| Len(Arg1) | Retorna o comprimento de Arg1. Arg1 é do tipo string e o resultado é do tipo inteiro. Exemplos: Len("Hello") → 5 Len(null) → (Vazio) |
| Lower(Arg1) | Retorna Arg1 convertido em minúsculas. Arg1 e o resultado são do tipo string. |
| Mid(Arg1, Arg2, Arg3) | Retorna os subcaracteres de Arg1 começando no índice Arg2 com um comprimento de caracteres de Arg3. Arg1 e o resultado são do tipo string. Arg2 e Arg3 são do tipo real, mas somente a parte inteira é utilizada. Se Arg2 > Len(Arg1), uma sequência de caracteres vazia será retornada. Além disso, se Arg2+Arg3 > Len(Arg1), Arg3 forem ajustados para 1+Len(Arg1)-Arg2. Se Arg2 ou Arg3 for negativo ou se Arg2 for zero, será retornado um erro. Exemplos: Mid("Daddy", 2, 3) → "add" Mid("Daddy", 386, 4) → "" Mid("Daddy", 4, 386) → "dy" Mid("Daddy", -1, 2) → (Vazio) Mid("Daddy", 2, -1) → (Vazio) |
| MostCommon(Arg1) | Retorna o valor mais comum da coluna especificada. Se muitos valores forem igualmente comuns, o primeiro será utilizado. Exemplo: MostCommon([Column]) |
| NameDecode(Arg1) | Substitui todos os códigos de subcaracteres com os caracteres decodificados. Os nomes das colunas no TIBCO Spotfire® são armazenados como caracteres codificados de UTF-16. Exemplo: NameDecode("Column %02D") |
| NameEncode(Arg1) | Codifica os caracteres nos caracteres, de modo que os caracteres contenham apenas caracteres correspondentes à expressão regular [.0-9a-zA-Z]. Os nomes das colunas no TIBCO Spotfire® são armazenados como caracteres codificados de UTF-16. Exemplo: NameEncode("Column £") |
| Repeat | Repete caracteres de um determinado número de vezes. Exemplo: Repeat("Hello", 2) → "HelloHello" |
| Right(Arg1, Arg2) | Retorna os últimos caracteres Arg2 dos caracteres Arg1. Arg1 e o resultado são do tipo string. Arg2 é do tipo real, mas somente a parte inteira é utilizada. Se Arg2 > que o comprimento do Arg1, todos os caracteres serão retornados. Se Arg2 for negativo, o número de caracteres Arg2 será removido do lado esquerdo da sequência de caracteres Arg1. Exemplos: Right("Daddy", 1) → "y" Right("Daddy", 3.99) → "ddy" Right("Daddy", 386) → "Daddy" Right("Daddy", -1) → "addy" |
| RXExtract(Arg1, Arg2, Arg3) |
Retorna a parte de caracteres (Arg1) que correspondem a uma expressão regular (Arg2). Arg3 determina qual correspondência deve ser usada quando existem várias correspondências. Exemplos: RXExtract([Column], "l+", 1) RXExtract("Parallel", "l+", 1) → "ll" RXExtract("Parallel", "l+", 2) → "l" |
| RXReplace(Arg1, Arg2, Arg3, Arg4) | Substitui subcaracteres de acordo com uma expressão regular. Pesquise a expressão regular Arg2 no Arg1 e substitua-a por Arg3. O Arg4 especifica as opções para a substituição: O "g" indica que, se Arg2 se correlacionar mais de uma vez, então todas correlações deverão ser substituídas. "i" especifica que a comparação não deve diferenciar maiúsculas de minúsculas. "s", para o modo de linha única, especifica que o ponto (.) corresponde a cada caractere (em vez de cada caractere, exceto nova linha). Alguns caracteres, como o caractere de barra invertida "\" e os parênteses "(" e ")", devem ser precedidos para trabalhar ao usar colunas calculadas. Como os parênteses são usados para o agrupamento em expressões regulares, "(" e ")" deverão ter escape caso o sinal ( ou ) deva ser correspondido. Além disso, quando o caractere é usado em uma expressão regular, as barras invertidas duplas são necessárias para escapar os caracteres do Spotfire e a expressão regular. Veja a literatura sobre elementos de linguagem de expressão regular, por exemplo, no MSDN, para mais informações. Exemplos: RXReplace("Hello", "L+", "LL", "i") → "HeLLo" RXReplace("3 Minor", "(\\d).*", "$1", "") → 3 RXReplace([Column with values within parenteses], "\\(89\\)", "", "") RXReplace("change\\slashdirection","\\\\","/","") → change/slashdirection (No último exemplo, a barra invertida precisa ser precedida duas vezes; uma para os caracteres Spotfire e uma vez para a expressão regular.) |
| Split(Arg1, Arg2, Arg3) | Divide os valores em Arg1 em vários subcaracteres, usando Arg2 como separador. Arg3
especifica qual dos valores deve ser retornado como uma nova coluna. Somente uma coluna é retornada. Utilize um Arg3 negativo para especificar que a divisão deve ser feita do fim da sequência de caracteres em direção ao começo, e não o contrário. Por exemplo, se uma coluna denominada "X" com o valor "a.b" for dividida em duas partes utilizando o separador ".", Split([X],".",1) retornará "a" e Split([X],".",2) retornará "b". Exemplos: Split([Column]," ",2) Split([Column]," ",-2) Split([Column]," / ",3) |
| Substitute(Arg1, Arg2, Arg3) | Substitui todas as ocorrências de Arg2 em Arg1 por Arg3. A pesquisa é sensível a maiúsculas. Exemplo: Substitute("Test","t","ting") → "Testing" |
| Substring(Arg1, Arg2, Arg3) | Retorna os subcaracteres de Arg1 começando no índice Arg2 com um comprimento de caracteres de Arg3. Arg1 e o resultado são do tipo string. Arg2 e Arg3 são do tipo real, mas somente a parte inteira é utilizada. Se Arg2 > Len(Arg1), uma sequência de caracteres vazia será retornada. Além disso, se Arg2 +
Arg3 > Len(Arg1), Arg3 forem ajustados para 1+Len(Arg1) -
Arg2. Se Arg2 ou Arg3 for negativo ou se Arg2 for zero, será retornado um erro. Exemplos: Substring("Daddy", 2, 3) → "add" Substring("Daddy", 386, 4) → "" Substring("Daddy", 4, 386) → "dy" Substring("Daddy", -1, 2) → (Vazio) Substring("Daddy", 2, -1) → (Vazio) |
| Trim(Arg1) | Remove caracteres com espaço em branco desde o início até o fim de caracteres. Exemplo: Trim(" Example ") → "Example" |
| UniqueConcatenate(Arg1) | Concatena os valores originais convertidos em caracteres. Os valores são ordenados de acordo com o comparador. Exemplo: UniqueConcatenate([Column]) |
| Upper(Arg1) | Retorna Arg1 convertido em maiúsculas. Arg1 e o resultado são do tipo string. Exemplo: Upper("hello") → "HELLO" |