Wave Analytics SAQL リファレンス
j文字列関数
SAQL 演算子は文字列をサポートし、coalesce() 関数は文字列が含まれるリストで最初の null 以外の項目を返します。文字列の操作専用の SAQL 関数一覧を次の表に示します。
関数
| 関数 | 説明 |
|---|---|
| ends_with(string, suffix) |
この関数は、string が suffix で終了する場合は true、それ以外の場合は false を返します。文字列の比較では、大文字と小文字は区別されません。いずれかのパラメータが null の場合、関数は null を返します。suffix が空の文字列の場合、関数は null を返します。 |
| index_of(string, searchStr [,position [, occurence]]) |
この関数は、string 内の指定された position から、searchStr が occurrence 番目に一致した位置のインデックスを返します。searchStr が見つからない場合は 0 が返されます。この関数では、大文字と小文字が区別されます。いずれかのパラメータが null の場合、関数は null を返します。 position のデフォルト値は 1 です。つまり、関数は string の最初の文字から検索を開始します。position が負または 0 の場合、エラーが発生します。 指定されている場合、occurrence は string 内の何番目の一致を検索するかを示す整数です。occurrence の値は正にする必要があり、省略した場合はデフォルトで 1 が設定されます。たとえば、複数の一致があり、occurence が 2 の場合は、2 番目に一致した位置のインデックスを返します。 position および occurrence では定数値がサポートされ、任意の式はサポートされていません。 searchStr が空の文字列の場合、関数は null を返します。 |
| len(string) | この関数は、文字列内の文字数を返します。
len は、string の長さを文字数で返します。string が null の場合、len(string) も null になります。 先頭および末尾の空白文字は、返される長さに含まれます。 |
| lower(string) |
この関数は、string のすべての文字を小文字にして返します。string が null の場合、結果は null になります。Unicode の大文字と小文字の対応関係に関する upper() のメモを参照してください。 |
| ltrim(string,chars) | この関数は、文字列の左から指定した文字までを削除するか、先頭のスペースを削除します。
ltrim は、chars に含まれない文字の最初の位置より左側を削除した string の値を返します。 chars には複数の文字を含めることができます。chars を省略した場合、先頭の空白文字が削除されます。string または chars が null の場合、結果は null になります。 |
| replace(string、searchStr、replaceStr) |
この関数は、一致するすべての searchStr を replaceStr で置き換えた string を返します。いずれかのパラメータが null の場合、関数は null を返します。searchStr が空の文字列の場合、null が返されます。この関数では、大文字と小文字が区別されます。 |
| rtrim(string,chars) | この関数は、文字列の右から指定した文字までを削除するか、末尾のスペースを削除します。
rtrim は、chars に含まれない文字の最後の位置より右側を削除した string の値を返します。 chars には複数の文字を含めることができます。chars を省略した場合、末尾の空白文字が削除されます。string または chars が null の場合、結果は null になります。 |
| starts_with(string, prefix) |
この関数は、string が prefix で開始する場合は true、それ以外の場合は false を返します。文字列の比較では、大文字と小文字は区別されません。いずれかのパラメータが null の場合、関数は null を返します。prefix が空の文字列の場合、関数は null を返します。 |
| substr(string,position[, length]) | この関数は、指定した位置で開始するサブ文字列を返します。必要に応じて、返されるサブ文字列の長さを指定します。
substr は、string から文字位置 position で開始する length 文字を返します。length を省略した場合、length = len(string) になるため、position から文字列の末尾までのすべての文字が返されます。いずれかのパラメータが null の場合、関数は null を返します。 string の最初の文字の位置は 1 です。position が負の場合、位置は文字列の末尾に対する相対位置になります。したがって、-1 のposition は最後の文字を示します。 length が負の場合、関数は null を返します。position > len (string)、position < -len(string)、または position = 0 の場合、空の文字列が返されます。 |
| trim(string,chars) | この関数は、文字列の左右から指定した文字までを削除するか、先頭と末尾のスペースを削除します。 trim は、chars に含まれない文字の最初と最後の位置より外側を削除した string の値を返します。 chars には複数の文字を含めることができます。chars を省略した場合、先頭と末尾の空白文字が削除されます。string または chars が null の場合、結果は null になります。 |
| upper(string) |
この関数は、string のすべての文字を大文字にして返します。string が null の場合、結果は null になります。 |