Replace

説明

string 内の指定された scope 内にある substring1 を object に置き換えます。この検索では大文字と小文字が区別されます。

この関数は、引数の代わりに文字列関数またはコールバック関数を引数として取り、文字列と置き換えることができます。

戻り値

置換後の文字列

カテゴリ

文字列関数

関数のシンタックス

Replace(string, substring, obj [, scope ],start)

履歴

ColdFusion(2021 リリース):

  • パラメーター start が追加されました。
  • また、コールバックがサポートされるようになりました。

パラメーター

パラメーター

説明

string

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

substring1

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

obj

substring1 を置き換える文字列、またはコールバック関数。この引数にはコールバック関数を渡すこともできます。

function(transform,position,original) {...}

scope

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

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.

 Adobe

ヘルプをすばやく簡単に入手

新規ユーザーの場合