fn:translate 関数
fn:translate 関数は、ストリング内の選択された文字列を置換文字列で置換します。
構文
>>-fn:translate(source-string,original-string,replacement-string)-><
- source-string
- 文字列が変換されるストリング。
source-string は、xs:string データ・タイプであるか、空のシーケンスです。
- original-string
- 変換可能な文字列を含むストリング。
original-string は xs:string データ・タイプです。
- replacement-string
- original-string 内の文字列を置換する文字列を含むストリング。
replacement-string は xs:string データ・タイプです。
replacement-string の長さが original-string の長さより大きい場合、replacement-string 内の追加文字列は無視されます。
戻り値
source-string が空のシーケンスでない場合、戻り値は以下の操作を実行した結果の xs:string 値です。
- original-string に現れる source-string 内のそれぞれの文字について、source-string 内の文字を、original-string 内の文字と同じ位置に現れる replacement-string 内の文字で置換します。
original-string の長さが replacement-string の長さより大きい場合、original-string には現れるが、original-string における文字位置が replacement-string 内に対応する位置を持たないような、source-string 内の各文字を削除します。
ある文字が original-string 内に複数回現れる場合、original-string におけるその文字の最初のオカレンスの位置が、使用される replacement-string 内の文字を決定します。
- original-string に現れない source-string 内の各文字については、その文字をそのままにしておきます。
source-string が空のシーケンスである場合、ゼロ長ストリングが戻されます。
例
次の関数は、ストリング "—aaa—" の文字 a を文字 A で置き換えて - 文字を削除します。
fn:translate("---aaa---","a-","A")
戻り値は "AAA" です。
