テキスト関数

式に使用できるテキスト関数のリストを示します。


関数	説明
`~=`	`If` または `Case` ステートメントの一部として使用できます。`Arg2` の正規表現文字列が `Arg1` の文字列に一致する場合は `true` を返します。例: `If( "aab" ~= "a+" , "true", "false" )` `Case when "aba" ~= ".a+$" then "true" else "false" end`
`Concatenate(Arg1, ...)`	すべての引数を連結 (付加) して文字列にします。1 つの引数が指定された場合は、すべてのローが連結されます。複数の引数が指定された場合は、各ローが連結されます。引数には任意の型を指定できますが、文字列に変換されます。結果は文字列型です。NULL の引数は無視されます。例: `Concatenate("April ", 20+1, "st")` → `"April 21st"` `Concatenate(null, "Ape")`→ `"Ape"` `Concatenate (null, null)` → (空)
`Find(Arg1, Arg2, Arg3)`	`Arg2` における文字列 `Arg1` の最初の出現について、インデックス番号を返します。`Arg3` は返す一致をオプションで示します。3 つ目の引数が指定されない場合、最初の一致が返されます。一致が見つからない場合には、0 を返します。検索キーワードは、大文字と小文字が区別されます。最初の 2 つの引数の型は文字列で、3 つ目の引数と結果の型は整数です。`Arg1` が空文字列の場合には、0 を返します。例: `Find("lo", "Hello")` → 4 `Find("a", "Hello")` → 0 `Find("", "Hello")` → 0 `Find("", null)` → (空) `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)`	文字列 `Arg1` の最初の `Arg2` 文字を返します。`Arg1` および結果は文字列型です。`Arg2` は実数型ですが、整数部だけが使用されます。「`Arg2` の長さ」 `>` 「`Arg1` の長さ」の場合は、文字列全体を返します。`Arg2` が負の場合、`Arg2` の文字数は `Arg1` 文字列の右側から削除されます。例: `Left("Daddy", 1)` → `"D"` `Left("Daddy", 3.99)` → `"Dad"` `Left("Daddy", 386)` → `"Daddy"` `Left("Daddy", -1)` → `"Dadd"`
`Len(Arg1)`	`Arg1` の長さを返します。`Arg1` は文字列型で、結果は整数型です。例: `Len("Hello")` → 5 `Len(null)` → (空)
`Lower(Arg1)`	`Arg1` を小文字に変換して返します。`Arg1` および結果は文字列型です。
`Mid(Arg1, Arg2, Arg3)`	`Arg2` で指定したインデックスで始まる `Arg3` で指定した文字分の `Arg1` の部分文字列を返します。`Arg1` および結果は文字列型です。`Arg2` と `Arg3` は実数型ですが、整数部だけが使用されます。`Arg2 > Len(Arg1)` の場合には、空文字列を返します。また、`Arg2+Arg3 > Len(Arg1)` の場合には、`Arg3` は `1+Len(Arg1)-Arg2` に調整されます。`Arg2` または`Arg3` が負の場合、あるいは `Arg2` が 0 の場合には、エラーを返します。例: `Mid("Daddy", 2, 3)` → `"add"` `Mid("Daddy", 386, 4)` → `""` `Mid("Daddy", 4, 386)` → `"dy"` `Mid("Daddy", -1, 2)` → (空) `Mid("Daddy", 2, -1)` → (空)
`MostCommon(Arg1)`	指定されたカラムの最大の共通値を返します。同一の値がいくつかある場合は、最初の値が使用されます。例: `MostCommon([Column])`
`NameDecode(Arg1)`	すべての部分文字列をデコードされた文字で置き換えます。 TIBCO Spotfire® のカラム名は、UTF-16 でエンコードされた文字列として格納されます。例: `NameDecode("Column %02D")`
`NameEncode(Arg1)`	正規表現 `[.0-9a-zA-Z]` に一致する文字のみが文字列に含まれるように、文字列の文字をエンコードします。 TIBCO Spotfire® のカラム名は、UTF-16 でエンコードされた文字列として格納されます。例: `NameEncode("Column £")`
`Repeat`	指定された回数だけ文字列を繰り返します。例: `Repeat("Hello", 2)` → `"HelloHello"`
`Right(Arg1, Arg2)`	文字列 `Arg1` の最後の `Arg2` 文字を返します。`Arg1` および結果は文字列型です。`Arg2` は実数型ですが、整数部だけが使用されます。`Arg2 >` 「`Arg1` の長さ」の場合は、文字列全体を返します。 `Arg2` が負の場合、`Arg2` の文字数は `Arg1` 文字列の左側から削除されます。例: `Right("Daddy", 1)` → `"y"` `Right("Daddy", 3.99)` → `"ddy"` `Right("Daddy", 386)` → `"Daddy"` `Right("Daddy", -1)` → `"addy"`
`RXExtract(Arg1, Arg2, Arg3)`	文字列 (`Arg1`) から、正規表現 (`Arg2`) に一致する部分を返します。`Arg3` は、複数の一致が見つかった場合にどの一致を使用するかを決定します。例: `RXExtract([Column], "l+", 1)` `RXExtract("Parallel", "l+", 1)` → `"ll"` `RXExtract("Parallel", "l+", 2)` → `"l"`
`RXReplace(Arg1, Arg2, Arg3, Arg4)`	正規表現に従って部分文字列を置換します。`Arg1` 内で `Arg2` の正規表現と一致する部分を検索して、その一致部分を `Arg3` で置換します。置換オプションを指定する `Arg4` は次のとおりです。 "g": `Arg2` と一致する文字列が複数ある場合はすべての一致部分が置換されます。 "i": 比較する際に大文字と小文字を区別します。 "s": 一括表示モードで指定すると、ピリオド (.) がすべての文字 (改行を除く) の代わりになります。バックスラッシュ文字 "\" やかっこ "(" と ")" など、一部の文字は、計算カラムを使用するときにエスケープして認識させる必要があります。かっこは正規表現でのグループ化に使用されるため、 "(" と ")" の両方は、( 記号または ) 記号が一致する必要がある場合はエスケープする必要があります。また、文字が正規表現で使用される場合、Spotfire 文字列と正規表現をエスケープするために二重バックスラッシュが必要になります。詳細については、MSDN など、正規表現の言語要素に関する資料を参照してください。例: `RXReplace("Hello", "L+", "LL", "i")` → `"HeLLo"` `RXReplace("3 Minor", "(\\d).*", "$1", "")` → 3 `RXReplace([Column with values within parenteses], "\$89\$", "", "")` `RXReplace("change\\slashdirection","\\\\","/","")` → `change/slashdirection` (最後の例では、バックスラッシュが 2 回エスケープされる必要があります。Spotfire 文字列で 1 回と、正規表現で 1 回です。)
`Split(Arg1, Arg2, Arg3)`	`Arg2` を区切り記号として使用して、`Arg1` の値を複数の部分文字列に分割します。`Arg3` はどの値を新しいカラムとして返すかを指定します。1 つのカラムのみが表示されます。文字列の先頭から末尾ではなく、末尾から先頭に向かって分割する場合は、負の `Arg3` を使用します。たとえば、"X" というカラムに "`a.b`" という値が含まれていて、区切り記号 "`.`" を使用して 2 つの部分に分割される場合、`Split([X],".",1)` は "`a`" を返し、`Split([X],".",2)` は "`b`" を返します。例: `Split([Column]," ",2)` `Split([Column]," ",-2)` `Split([Column]," / ",3)`
`Substitute(Arg1, Arg2, Arg3)`	`Arg1` に含まれるすべての `Arg2` を `Arg3` に置換します。検索キーワードは、大文字小文字が区別されます。例: `Substitute("Test","t","ting")` → `"Testing"`
`Substring(Arg1, Arg2, Arg3)`	`Arg2` で指定したインデックスで始まる `Arg3` で指定した文字分の `Arg1` の部分文字列を返します。`Arg1` および結果は文字列型です。`Arg2` と `Arg3` は実数型ですが、整数部だけが使用されます。`Arg2 > Len(Arg1)` の場合には、空文字列を返します。また、`Arg2 + Arg3 > Len(Arg1)` の場合には、`Arg3` は `1+Len(Arg1) - Arg2` に調整されます。`Arg2` または`Arg3` が負の場合、あるいは `Arg2` が 0 の場合には、エラーを返します。例: `Substring("Daddy", 2, 3)` → `"add"` `Substring("Daddy", 386, 4)` → `""` `Substring("Daddy", 4, 386)` → `"dy"` `Substring("Daddy", -1, 2)` → (空) `Substring("Daddy", 2, -1)` → (空)
`Trim(Arg1)`	文字列の先頭と末尾の空白文字を削除します。例: `Trim(" Example "`) → `"Example"`
`UniqueConcatenate(Arg1)`	文字列に変換された固有値を連結します。これらの値は比較演算子に従って順序付けされます。例: `UniqueConcatenate([Column])`
`Upper(Arg1)`	`Arg1` を大文字に変換して返します。`Arg1` および結果は文字列型です。例: `Upper("hello")` → `"HELLO"`

「関数」も参照してください。