2.3.2.3. 文字列関数
以下の関数は、文字列の操作をサポートします。
FEEL では、Unicode 文字はコードポイントを基にカウントされます。
- substring( string, start position, length? )
指定の長さの開始地点からサブ文字列を返します。最初の文字の位置値は
1です。Expand 表2.16 パラメーター パラメーター タイプ stringstringstart positionnumberlength(任意)number例
substring( "testing",3 ) = "sting" substring( "testing",3,3 ) = "sti" substring( "testing", -2, 1 ) = "n" substring( "\U01F40Eab", 2 ) = "ab"注記FEEL では、文字リテラルの
"\U01F40Eab"は🐎ab文字列 (馬の記号の後にaとb) となります。
- string length( string )
指定の文字列の長さを計算します。
Expand 表2.17 パラメーター パラメーター タイプ stringstring例
string length( "tes" ) = 3 string length( "\U01F40Eab" ) = 3
- upper case( string )
指定の文字列の大文字バージョンを生成します。
Expand 表2.18 パラメーター パラメーター タイプ stringstring例
upper case( "aBc4" ) = "ABC4"
- lower case( string )
指定の文字列の小文字バージョンを生成します。
Expand 表2.19 パラメーター パラメーター タイプ stringstring例
lower case( "aBc4" ) = "abc4"
- substring before( string, match )
一致した値の前にあるサブ文字列を計算します。
Expand 表2.20 パラメーター パラメーター タイプ stringstringmatchstring例
substring before( "testing", "ing" ) = "test" substring before( "testing", "xyz" ) = ""
- substring after( string, match )
一致した値の後にあるサブ文字列を計算します。
Expand 表2.21 パラメーター パラメーター タイプ stringstringmatchstring例
substring after( "testing", "test" ) = "ing" substring after( "", "a" ) = ""
- replace( input, pattern, replacement, flags? )
正規表現の置換を計算します。
Expand 表2.22 パラメーター パラメーター タイプ inputstringpatternstringreplacementstringflags(任意)string注記この関数は、XQuery 1.0 and XPath 2.0 Functions and Operators で定義されている正規表現パラメーターを使用します。
例
replace( "abcd", "(ab)|(a)", "[1=$1][2=$2]" ) = "[1=ab][2=]cd"
- contains( string, match )
文字列に一致部分が含まれる場合に
trueを返します。Expand 表2.23 パラメーター パラメーター タイプ stringstringmatchstring例
contains( "testing", "to" ) = false
- starts with( string, match )
指定の値と一致する文字列で開始する場合に、
trueを返します。Expand 表2.24 パラメーター パラメーター タイプ stringstringmatchstring例
starts with( "testing", "te" ) = true
- ends with( string, match )
指定の値と一致する文字列で終了する場合に、
trueを返します。Expand 表2.25 パラメーター パラメーター タイプ stringstringmatchstring例
ends with( "testing", "g" ) = true- matches( input, pattern, flags? )
入力が正規表現と一致する場合に
trueを返します。Expand 表2.26 パラメーター パラメーター タイプ inputstringpatternstringflags(任意)string注記この関数は、XQuery 1.0 and XPath 2.0 Functions and Operators で定義されている正規表現パラメーターを使用します。
例
matches( "teeesting", "^te*sting" ) = true- split( string, delimiter )
元の文字列のリストを返し、区切り文字の正規表現パターンで分割します。
Expand 表2.27 パラメーター パラメーター タイプ stringstringdelimiter正規表現パターンの
string注記この関数は、XQuery 1.0 and XPath 2.0 Functions and Operators で定義されている正規表現パラメーターを使用します。
例
split( "John Doe", "\\s" ) = ["John", "Doe"] split( "a;b;c;;", ";" ) = ["a","b","c","",""]