StrReplace

指定された部分文字列を新しい文字列で置き換えます。

ReplacedStr := StrReplace(Haystack, Needle , ReplaceText, CaseSense, &OutputVarCount, Limit)

パラメータ

Haystack

型：文字列

内容を検索・置換する文字列。

Needle

型：文字列

検索する文字列です。

ReplaceText

型：文字列

空白または省略したときは、Needleは空白（空）に置き換えられ、戻り値から省略されます。それ以外の場合は、Needleを置き換える文字列を指定する。

CaseSense

型：文字列 or 整数（ブーリアン）

省略したときは、Offが初期値になります。そうでないときは、次のいずれかの値を指定します：

On または 1 (true)：検索では大文字と小文字が区別されます。

Off または 0 (false)：検索では大文字と小文字が区別されないため、A-Z の文字は小文字の文字と同一と見なされます。

Locale：検索では、現在のユーザーのロケールの規則に従って大文字と小文字は区別されません。例えば、英語や西欧のロケールでは、A～Zの小文字だけでなく、ÄやÜなどの非ASCII文字も小文字と同じように扱われることがほとんどです。Localeは、比較する文字列の性質によって、Offの1～8倍遅くなります。

&OutputVarCount

型：VarRef

省略したときは、対応する値は保存されません。そうでないときは、置換が発生した回数を格納する出力変数への参照を指定する（何もない場合は0）。

Limit

型：整数

省略すると、初期値は-1となってHaystack で見つかったすべてが置き換えられます。そうでないときは、置換を許可する最大数を指定します。ヘイスタックの右側はそのまま。

戻り値

型：文字列

この関数は、指定された文字列の置換されたバージョンを返す。

備考

組み込み変数A_Spaceと A_Tabには、それぞれスペースとタブが1文字ずつ格納される。スペースやタブを単独で、あるいはニードルの先頭や末尾で検索する場合に便利である。

関連

RegExReplace、InStr、SubStr、StrLen、StrLower、StrUpper

例

A_Clipboard := StrReplace(A_Clipboard, "`r`n")

NewStr := StrReplace(OldStr, A_Space, "+")

Loop
{
    MyString := StrReplace(MyString, "`r`n`r`n", "`r`n",, &Count)
    if (Count = 0)  ; No more replacements needed.
        break
}