REPLACELIST |
説明 文字列内で複数種類の要素を検索し、対応する別の要素に置き換えます。検索対象の要素と、それらに対応する置き換え要素は、それぞれカンマ区切りリストで指定します。この検索では大文字と小文字が区別されます。
戻り値 文字が置換された文字列のコピー
カテゴリ リスト関数、文字列関数
関数のシンタックス
    ReplaceList(string, list1, list2)
関連項目 Find、REFind、Replace、REReplace
パラメータ
使用方法 検索する部分文字列のリストは、先頭の要素から順番に処理されます。list1 に含まれる要素のいずれかの内容が list2 の要素内にも出現する場合、再帰的な置換処理が発生する可能性があります。そのような例を次に示します。
例
    <p>ReplaceList 関数は、<I>string</I> 内の指定されたスコープにある
    <I>substringlist1</I> (例 : "a,b") を <I>substringlist2</I>
    (例 : "c,d") に置き換えた文字列を返します。
    <cfif IsDefined("FORM.MyString")>
    <p>元の文字列 : <cfoutput>#FORM.MyString#</cfoutput>
    <p>部分文字列 <cfoutput>#FORM.MySubstring1# を、
     </cfoutput>
    部分文字列 <cfoutput>#FORM.MySubstring2#</cfoutput> に置き換えます。
    <p>結果 : <cfoutput>#Replacelist(FORM.myString,
    FORM.MySubstring1, FORM.mySubString2)#</cfoutput>
    </cfif>
    <form action = "replacelist.cfm" method="post">
    <p>文字列 1
    <br><input type = "Text" value = "My Test String" name = "MyString">
    <p>部分文字列 1 (検索する部分文字列のリストを指定します)
    <br><input type = "Text" value = "Test, String" name = "MySubstring1">
    <p>部分文字列 2 (置き換える文字列のリストを指定します)
    <br><input type = "Text" value = "Replaced, Sentence" name = "MySubstring2">
    <p><input type = "Submit" value = "Replace and display" name = "">
    </form>

    <h3>Replacelist の例 2</h3>
    <cfset stringtoreplace = "The quick brown fox jumped over the lazy dog.">
    <cfoutput>
       #ReplaceList(stringtoreplace,"dog,brown,fox,black", "cow,black,ferret,white")#
    </cfoutput>

STRING |
置き換えを実行する対象の文字列、またはそのような文字列を含んでいる変数です。

LIST1 |
検索する部分文字列を指定するカンマ区切りリストです。

LIST2 |
部分文字列を置き換える文字列を指定するカンマ区切りリストです。