Функция StringReplace

         Описание функции


StringReplace

Заменяет фрагмент в строке.

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

Параметры

string Строка, в которой выполняется замена.
searchstring/start Строка поиска или позиция символа начала замены.
replacestring Строка замены.
occurrence [необязательный] Количество выполняемых замен. Используйте отрицательное число, чтобы выполнить замену справа.
0 = выполнить замену всех найденных строк (по умолчанию)
casesense [необязательный] Флаг установки чувствительности к регистру написания.
0 = (по умолчанию) не учитывать регистр, используется локальный язык
1 = учитывать регистр
2 = не учитывать регистр, используется основное / быстрое сравнение

Возвращаемое значение

Возвращает новую строку, в @extended содержится число замен.

Примечания

По умолчанию или при положительном occurrence поиск/замена производится слева направо. Таким образом, StringReplace("aaa", "aa", "bb") возвращает "bba"

Если используется метод замены в указанной позиции, то параметры occurrence и casesense игнорируются. Если замена строки не может быть сохранена, то возвращается пустая строка и @error устанавливается равным 1.

См. также

StringRegExpReplace, StringInStr, StringStripWS, StringAddCR, StringLeft, StringLen, StringMid, StringRight, StringTrimLeft, StringTrimRight

Пример

; Пример 1, замена текста
$sText = StringReplace("это строка текста", " ", "---")
$iReplacements = @extended
MsgBox(4096, 'Строка после замены', $sText & @CRLF & @CRLF & _
        'Количество сделанных замен: ' & $iReplacements)

; Пример 2, замена в позиции
$sText = StringReplace("это строка текста", 6, "---")
MsgBox(0, 'Замена в позиции', $sText)