パラメーター
最終更新日 :
2021年4月28日
|
次にも適用 : ColdFusion
説明
string 内の指定された scope 内にある substring1 を object に置き換えます。この検索では大文字と小文字が区別されます。
この関数は、引数の代わりに文字列関数またはコールバック関数を引数として取り、文字列と置き換えることができます。
戻り値
置換後の文字列
カテゴリ
関数のシンタックス
Replace(string, substring, obj [, scope ],start)
履歴
ColdFusion（2021 リリース）:
- パラメーター start が追加されました。
- また、コールバックがサポートされるようになりました。
パラメーター
|
|
説明 |
|
string |
文字列、または文字列を含んでいる変数です。検索対象の文字列を指定します。 |
|
substring1 |
文字列、または文字列を含んでいる変数です。この文字列が出現する箇所を検索します。 |
|
obj |
substring1 を置き換える文字列、またはコールバック関数。この引数にはコールバック関数を渡すこともできます。 function(transform,position,original) {...} |
|
scope |
|
|
start |
文字列で検索を開始する位置を指定します（1 から始まります）。 |
使用方法
文字列を削除する場合は、substring2 に空の文字列（""）を指定します。文字列内のカンマ文字をエスケープする必要はありません。例えば、次のコードでは文中からカンマを削除します。
replace("The quick brown fox jumped over the lazy cow, dog, and cat.",",","","All") |
例
<cfoutput>#replace("The quick brown fox","o","cf","all")#</cfoutput>
このコードの出力は次のようになります。
The quick brcfwn fcfx
コールバック関数を使用した場合の例
<cfscript>
myStr="happy app application apply appreciate appreciation Apprentice";
outStr = replace( myStr, "app", function (transform, position, original){
return UCase(transform);
}, "all");
writeoutput(outStr);
</cfscript>
このコードの出力は次のようになります。
hAPPy APP APPlication APPly APPreciate APPreciation APPrentice
例 2
<cfscript>
mystring="The quick brown fox jumped over the lazy cow."
substring="ow"
replacement="aze"
scope="ALL"
start=len("The quick brown")
writeOutput(replace(mystring,substring,replacement,scope,start))
writeOutput("<br/>")
// Scope="ONE"
writeOutput(replace(mystring,substring,replacement,"ONE",start))
</cfscript>
出力
The quick brown fox jumped over the lazy caze.
The quick brown fox jumped over the lazy caze.
例 3
<cfscript>
// Define the callback function
callback=(regexp,position,original)=>{
retString = regExp.reverse()&"aze"
return retString
}
baseStr="The quick brown fox jumped over the lazy cow."
writeOutput(replace(baseStr, "ow", callback, "all", len("The quick bro")) & "<br>")
writeOutput(replace(baseStr, "ow", callback, "all", len("The quick brown")) & "<br>")
</cfscript>
出力
The quick brwoazen fox jumped over the lazy cwoaze.
The quick brown fox jumped over the lazy cwoaze.
