Function Reference

StringReplace

文字列中の部分文字列を入れ換えます。

StringReplace ( "string", "searchstring/start", "replacestring" [, occurrence [, casesense]] )

 

パラメータ

string 対象となる文字列
searchstring/start 検索対象の部分文字列もしくは入れ換え開始の文字位置
replacestring 入れ換え文字列
occurrence [オプション] 検索文字列の入れ換え回数。右側から置換をおこなうには負の数を使用してください。
0 = 全ての検索文字列が入れ換えられます(デフォルト)。
casesense [オプション] 大文字小文字の区別を指定するフラグ
0 = 区別しません。ユーザーのロケールを使用します。(デフォルト)
1 = 区別します。
2 = 区別しません。基本的/高速な比較を使用します。

 

返し値

新しい文字列が返されます。入れ換え回数は@extendedに代入されます。

 

注意

デフォルトの場合、occurrenceが正の場合は検索・入れ換えは左から右に実行されます。従ってStringReplace("aaa", "aa", "bb")は"bba"を返します。

startパラメータが指定された場合occurrenceパラメータとcasesenseパラメータは無視されます。入れ換えができなかった場合、空文字列が返され@errorが1に設定されます。

 

関連

StringLeft, StringLen, StringLower, StringMid, StringRight, StringTrimLeft, StringTrimRight, StringUpper, StringStripWS, StringAddCR

 


$text = StringReplace("this is a line of text", " ", "-")
$numreplacements = @extended
MsgBox(0, "New string is", $text)
MsgBox(0, "The number of replacements done was", $numreplacements)