ReplaceString

ReplaceString()

Синтаксис

String$ = ReplaceString(String$ , StringToFind$ , ReplacementString$ [, Mode [, StartPosition [, NbOccurrences]]])

Описание

Производит поиск вхождений подстроки 'StringToFind$' в строке 'String$' и заменяет их на подстроку 'ReplacementString$'.

Параметры

String$ Строка, в которой будет производиться замена.

StringToFind$ Подстрока, которую требуется заменить.

ReplacementString$ Подстрока, которая используется в качестве замены.
Mode (дополн.)
Этот параметр может быть комбинацией следующих значение (с помощью оператора '|'):
  #PB_String_CaseSensitive : С учетом регистра (A<>a) (по умолчанию)
  #PB_String_NoCase : Без учёта регистра (A=a)
  #PB_String_InPlace: Замена по месту. Это означает, что строка заменяется
         прямо в памяти. Параметры 'StringToFind$' и 'ReplacementString$' 
        должны иметь одинаковую длину. Это опасный способ только
        для продвинутых пользователей. Преимуществом является очень
        высокая скорость замены. При использовании этой опции,
        возвращаемый функцией ReplaceString() результат не берётся
        во внимание (в нём нет необходимости, так как изменение
        происходит со строкой, переданной в параметр).
StartPosition (дополн.) Позиция в строке String$, с которой начнётся поиск и замена. Первый символ в строке имеет позицию 1. Если этот параметр не указан, поиск и замена будут выполняться от начала строки.

NbOccurrences (дополн.) Задаёт количество производимых замен. Если опущено, то все найденные вхождения подстроки 'StringToFind$' будут заменены подстрокой 'ReplacementString$'.

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

Возвращает новую строку, содержащую строку 'String$', в которой произведены замены (см. #PB_String_InPlace для иного поведения).

Пример

Debug ReplaceString("Это было искусство", " было", " теперь") ; выведет "Это теперь искусство"
Debug ReplaceString("Hello again, hello again", "HELLO", "oh no...", 1, 10) ; выведет "Hello again, oh no... again"

test$ = "Bundy, Barbie, Buddy"
; все "B" изменятся на "Z" прямо в памяти, без возвращаемого значения
ReplaceString(test$, "B", "Z", 2, 1)
Debug test$ ; Результат изменённой строки

См. также

RemoveString(), InsertString()

Поддерживаемые OS

Все

<- RemoveString() - Оглавление String - ReverseString()->

String$	Строка, в которой будет производиться замена.
StringToFind$	Подстрока, которую требуется заменить.
ReplacementString$	Подстрока, которая используется в качестве замены.
Mode (дополн.)	Этот параметр может быть комбинацией следующих значение (с помощью оператора '\|'): #PB_String_CaseSensitive : С учетом регистра (A<>a) (по умолчанию) #PB_String_NoCase : Без учёта регистра (A=a) #PB_String_InPlace: Замена по месту. Это означает, что строка заменяется прямо в памяти. Параметры 'StringToFind$' и 'ReplacementString$' должны иметь одинаковую длину. Это опасный способ только для продвинутых пользователей. Преимуществом является очень высокая скорость замены. При использовании этой опции, возвращаемый функцией ReplaceString() результат не берётся во внимание (в нём нет необходимости, так как изменение происходит со строкой, переданной в параметр).
StartPosition (дополн.)	Позиция в строке String$, с которой начнётся поиск и замена. Первый символ в строке имеет позицию 1. Если этот параметр не указан, поиск и замена будут выполняться от начала строки.
NbOccurrences (дополн.)	Задаёт количество производимых замен. Если опущено, то все найденные вхождения подстроки 'StringToFind$' будут заменены подстрокой 'ReplacementString$'.