XPath 1.0 のコア関数 (4) : 文字列関数 (String Functions)

XPath 1.0 のコア関数（記事一覧）。　今回は残りの XPath 関数、文字列関数を見ていきます。　XPath 1.0 仕様書「4.2 String Functions」参照。

関数のシグニチャ

関数名	シグニチャ	返り値の型	説明
string()	string(object?)	string	「XPath 1.0 でのデータ型のキャスト」参照
concat()	concat(string, string, string*)	string	引数の文字列を連結した文字列を返す
start-with()	starts-with(string, string)	boolean	第1引数の文字列が第2引数の文字列で始まっているかどうかを返す
contains()	contains(string, string)	boolean	第1引数の文字列が第2引数の文字列を含むかどうかを返す
substring-before()	substring-before(string, string)	string	第1引数の文字列のうち、第2引数の文字列以前の部分文字列を返す
substring-after()	substring-after(string, string)	string	第1引数の文字列のうち、第2引数の文字列以降の部分文字列を返す
substring()	substring(string, number, number?)	string	第1引数の文字列に対して、第2、第3引数に応じて部分文字列を返す
string-length()	string-length(string?)	number	引数の文字列の長さを返す
normalize-space()	normalize-space(string?)	string	引数の文字列の空白を正規化して返す
translate()	translate(string, string, string)	string	第1引数の文字列に第2、第3引数に応じて置き換えを施す

string() 関数

以前の記事を参照。

シグニチャ

string(object?) : string

concat() 関数

引数の文字列を連結した文字列を返す。

シグニチャ

concat(string, string, string*) : string

サンプルの XPath 式

concat("gr", "ooo", "vy")

サンプルの評価結果

"grooovy" （文字列）

starts-with() 関数

1引数の文字列が第2引数の文字列で始まっているなら true を、そうでないなら false を返す。

シグニチャ

starts-with(string, string) : boolean

サンプルの XPath 式

starts-with("grooovy", "gr")

サンプルの評価結果

true （ブール値）

contains() 関数

第1引数の文字列が第2引数の文字列を含むなら true を、そうでないなら false を返す。

シグニチャ

contains(string, string) : boolean

サンプルの XPath 式

contains("grooovy", "ooo")

サンプルの評価結果

true （ブール値）

substring-before() 関数

第1引数の文字列のうち、第2引数の文字列以前の部分文字列を返す。　もう少し正確には

第1引数の文字列に対して、第2引数の文字列が最初に現れた位置以前の部分文字列を返す。

第１引数の文字列が第2引数の文字列を含んでいないなら、空文字列を返す。

シグニチャ

substring-before(string, string) : string

サンプルの XPath 式

substring-before("grooovy", "ooo")

サンプルの評価結果

"gr"

substring-after() 関数

第1引数の文字列のうち、第2引数の文字列以降の部分文字列を返す。　もう少し正確には

第1引数の文字列に対して、第2引数の文字列が最初に現れた位置以降の部分文字列を返す。

第１引数の文字列が第2引数の文字列を含んでいないなら、空文字列を返す。

シグニチャ

substring-after(string, string) : string

サンプルの XPath 式

substring-after("grooovy", "ooo")

サンプルの評価結果

"vy" （文字列）

substring() 関数

第1引数に対して、第2引数が指定する位置から第3引数が指定する長さだけ取り出した部分文字列を返す。

第3引数が省略された場合は、第2引数が指定する位置から第1引数の最後までの部分文字列を返す。

文字列を指定する位置は1から始まる。

シグニチャ

substring(string, number, number?) : string

サンプルの XPath 式

substring("grooovy", 2)
substring("12345", 1.5, 2.6)
substring("12345", 0, 3)
substring("12345", 0 div 0, 3)
substring("12345", 1, 0 div 0)
substring("12345", -42, 1 div 0)
substring("12345", -1 div 0, 1 div 0)