Replace

説明

文字列内の指定した範囲にある substring1substring2 に置き換えます。この検索では大文字と小文字が区別されます。

戻り値

置換後の文字列

カテゴリ

文字列関数

関数のシンタックス

Replace(string, substring1, substring2 [, scope ])

パラメータ

パラメータ

説明

string

文字列、または文字列を含んでいる変数です。検索対象の文字列を指定します。

substring1

文字列、または文字列を含んでいる変数です。この文字列が出現する箇所を検索します。

substring2

substring1 を置き換える文字列です。

scope

  • one: 最初に一致した箇所を置き換えます (デフォルト)。

  • all: 一致したすべての箇所を置き換えます。

使用方法

一致する箇所を削除するには、substring2 に空の文字列 ("") を指定します。

文字列内のカンマ文字をエスケープする必要はありません。たとえば、次の例は文中からカンマを削除するコードです。

replace("The quick brown fox jumped over the lazy cow, dog, and cat.",",","","All")

<h3>Replace Example</h3> 
 
<p>The Replace function returns <I>string</I> with <I>substring1</I>  
    replaced by <I>substring2</I> in the specified scope. This  
    is a case-sensitive search. 
 
<cfif IsDefined("FORM.MyString")> 
<p>Your original string, <cfoutput>#FORM.MyString#</cfoutput> 
<p>You wanted to replace the substring <cfoutput>#FORM.MySubstring1# 
    </cfoutput> 
    with the substring <cfoutput>#FORM.MySubstring2#</cfoutput>. 
<p>The result: <cfoutput>#Replace(FORM.myString,  
    FORM.MySubstring1, FORM.mySubString2)#</cfoutput> 
</cfif>