説明

正規表現を使用して、パターンに一致する文字列を検索し、別の文字列に置き換えます。この検索では大文字と小文字は区別されません。

戻り値

  • scope = "one" の場合は、正規表現に最初に一致した箇所を substring の値に置き換えた文字列。
  • scope = "all" の場合は、正規表現に一致したすべての箇所を substring の値に置き換えた文字列。
  • 正規表現に一致する箇所が見つからなかった場合は、元の文字列のコピーがそのまま返されます。

カテゴリ

文字列関数

関数のシンタックス

REReplaceNoCase(string, reg_expression, substring [, scope ])

関連項目

REFindREFindNoCaseReplaceReplaceList

履歴

ColdFusion(2018 リリース)アップデート:useJavaAsRegexEngine フラグが Application.cfc に追加されました。Java Regex をデフォルトの Regex エンジンとして使用するには、このフラグを有効にします。詳しくは、アプリケーション変数を参照してください。このフラグを使用した正規表現の利用については、正規表現の使用を参照してください。

ColdFusion MX:動作が変更されました。この関数では、大文字と小文字の変換を制御するための特殊文字 ¥u、¥U、¥l、¥L、¥E が、正規表現の置換文字列に挿入されます。ColdFusion 5 アプリケーションでこれらの文字列を使用している場合は、その前に円記号を挿入します("¥u" を "¥¥u" に変更するなど)。

パラメーター

パラメーター

説明

string

文字列、または文字列を含んでいる変数です。

reg_expression

置換対象箇所を検索する正規表現です。詳細については、『ColdFusion アプリケーションの開発』の関数での正規表現の使用を参照してください。

substring

文字列、または文字列を含んでいる変数です。reg_expression に一致した箇所をこの文字列で置き換えます。

scope

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

使用方法

正規表現の使用法の詳細については、『ColdFusion アプリケーションの開発』の関数での正規表現の使用を参照してください。

<cfscript>
    writeOutput(REReplace("CABARET","C|B","G","ALL") & "<br/>")
    writeOutput(REReplace("CABARET","C|B","G","ALL") & "<br/>")
    writeOutput(REReplace("CABARET","[A-Z]","G","ALL") & "<br/>")
    writeOutput(REReplace("CABARET","[A-Z]","G","ALL") & "<br/>")
    writeOutput(REReplace("I love jellies","jell(y|ies)","cookies") & "<br/>")
    writeOutput(REReplace("I love jellies","jell(y|ies)","cookies") & "<br/>")
    writeOutput(REReplace("I love jelly","jell(y|ies)","cookies") & "<br/>")
    writeOutput(REReplace("I love jelly","jell(y|ies)","cookies") & "<br/>")
</cfscript>

本作品は Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License によってライセンス許可を受けています。  Twitter™ および Facebook の投稿には、Creative Commons の規約内容は適用されません。

リーガルノーティス   |   プライバシーポリシー