translate

構文

    translate(string, string, string)

パラメータ

カンマで区切られた 3 つの string 値。最初の文字列は、文字が置換される文字列です。2 番目の文字列は、最初の文字列内のその存在が置換される文字を格納します。3 番目の文字列は、2 番目の文字列内の文字と対応する置換する文字を格納します。

2 番目の文字列内の文字は、3 番目の文字列内の同じインデックスを持つ文字と対応します。

• 2 番目の文字列が、3 番目の文字列より長い場合、3 番目の文字列の長さより大きいインデックスを持つ 2 番目の文字列内の文字には対応する文字がありません。

• 3 番目の文字列が 2 番目の文字列より長い場合、2 番目の文字列の長さより大きいインデックスを持つ、 3 番目の文字列内の文字は無視されます。

• 2 番目の文字列内に文字が複数存在している場合、最初の文字の存在によって、最初の文字列内のその文字の置換方法が決まります。

戻り値

置換された文字を含む最初のパラメーターを格納する文字列。

例

次の式には、3 番目のパラメーター内の文字にすべて対応する文字を含む 2 番目のパラメーターが含まれます。式は BAr を返します。

translate("bar","abc","ABC")

次の式には、3 番目のパラメーターより長い 2 番目のパラメーターが含まれます。式は AAA を返します。

translate("--aaa--","abc-","ABC")

次の式には、文字の複数の存在を含む 2 番目のパラメーターが含まれます。式は BAr を返します。

translate("bar", "aba", "ABC")