StrReplace

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

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

パラメータ

Haystack

型：文字列

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

Needle

型：文字列

検索する文字列です。

ReplaceText

型：文字列

If blank or omitted, Needle will be replaced with blank (empty), meaning it will be omitted from the return value. それ以外の場合は、Needleを置き換える文字列を指定する。

CaseSense

型：String or Integer (boolean)

If omitted, it defaults to Off. それ以外のときは、次のいずれかの値を指定します：

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

Off または 0 (false):The search is not case-sensitive, i.e. the letters A-Z are considered identical to their lowercase counterparts.

Locale: The search is not case-sensitive according to the rules of the current user's locale. 例えば、英語や西欧のロケールでは、A～Zの小文字だけでなく、ÄやÜなどの非ASCII文字も小文字と同じように扱われることがほとんどです。Localeは、比較する文字列の性質によって、Offの1～8倍遅くなります。

&OutputVarCount

型：VarRef

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

Limit

型：整数

If omitted, it defaults to -1, which replaces all occurrences of the pattern found in 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
}