StringReplace

Zastosowanie

Funkcja StringReplace zwraca nowy tekst, w którym wszystkie wystąpienia wskazanego fragmentu zastąpiono innym fragmentem. Jeżeli fragmentu oldValue nie ma w tekście, funkcja zwraca tekst bez zmian. Wielkość liter ma znaczenie.

Składnia

StringReplace("baseString","oldValue","newValue");

Argumenty

Argument	Typ	Wymagany	Opis
`baseString`	tekst	Tak	Tekst, który ma zostać zmieniony.
`oldValue`	tekst	Tak	Fragment, którego funkcja szuka w `baseString`.
`newValue`	tekst	Tak	Fragment, który zastąpi wszystkie wystąpienia `oldValue`.

Zwracana wartość

Funkcja zwraca tekst: tekst baseString, w którym wszystkie wystąpienia oldValue zastąpiono wartością newValue.

Przykłady

Przykład 1: zamiana kilku wystąpień

Zmienna replaced będzie zawierać wartość „some string instance and other instance”.

replaced = StringReplace("some string value and other value", "value","instance");

Przykład 2: zamiana fragmentu słowa

Zmienna replaced będzie zawierać wartość „abcqazqwe”.

replaced = StringReplace("abcxyzqwe", "xyz","qaz");

Przykład 3: brak szukanego fragmentu

Zmienna replaced będzie zawierać wartość „abcxyzqwe”, czyli tekst bez zmian.

replaced = StringReplace("abcxyzqwe", "not","found");

Dobre praktyki

Sprawdź, czy oldValue nie jest pusty.
Używaj funkcji do prostych zamian. Do złożonych wzorców użyj wyrażeń regularnych.

Typowe błędy

Pusty oldValue. Reguła zakończy się błędem. Sprawdź wartość oldValue przed wywołaniem funkcji.
Inna wielkość liter w oldValue. Funkcja rozróżnia wielkość liter, więc fragmenty zapisane inaczej nie zostaną zastąpione. Zapisz oldValue tak samo jak w baseString.

Powiązane funkcje