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" です。