CMNロゴ

ICmnPilot::cmnRegReplace Method

正規表現で置換を行ないます。

Syntax

BOOL cmnRegReplace(
    LPCSTR lpSource,
    LPCSTR lpPattern,
    LPCSTR lpReplace,
    LPSTR *ppDestString,
    LPCSTR lpFlag
);

Parameters

lpSource

[in] 置換対象の文字列

lpPattern

[in] 正規表現のパターン文字列
詳細はICmnPilot::cmnRegSearchを参照してください。

lpReplace

[in] 置換する文字列
以下の文字を使用することができます。
$$'$' という文字
$nn 番目のサブ式にマッチした部分文字列
$&マッチした部分文字列
$`マッチした位置より前方の部分文字列
$'マッチした位置より後方の部分文字列

ppDestString

[out] 置換された文字列
置換されなかった場合には lpSource と同じ内容となります。
使用後は領域を開放しなければなりません。

lpFlag

[in] 検索修飾子
指定できる修飾子は以下の通り。
i大文字・小文字無視
gグローバル検索

Return Value

置換されたかどうかに関わらず、処理が成功した場合には0以外、それ以外は0が戻ります。

Remarks

この機能はVBScriptのReplaceメソッドに相当します。
検索結果は保持されません。
処理が成功した場合、ppDestString は使用後にICmnPilot::cmnFreeで領域を開放しなければなりません。

Example

C++

         :
    LPSTR pResult;
    if (m_pICmnPilot->cmnRegReplace (pString, "[0-9]", "x", &pResult, "")) {
             :
         m_pICmnPilot->cmnFree (pResult);

Delphi

var
    pResult: LPSTR;
begin
         :
    if (m_pICmnPilot.cmnRegReplace (pString, '[0-9]', 'x', pResult, '')) then
    begin
             :
         m_pICmnPilot.cmnFree (pResult);


ICmnPilot