Blok funkcji PREG_REPLACE

Blok funkcji PREG_REPLACE wyszukuje i zastępuje za pomocą wyrażeń regularnych.

Uwaga: Ta funkcja jest Binary-Safe. Oznacza to, że znaki UTF8 nie mogą być bezpośrednio edytowane.

Wejście PATTERN

Wyrażenie jako ciąg znaków, którego szukamy. Dostępne są również niektóre modyfikatory PCRE.

Wejście REPLACEMENT

Ciąg znaków do zastąpienia. Może on zawierać odniesienia w postaci \n lub $n, przy czym te drugie są preferowane. Każde z tych odniesień zostaje zastąpione tekstem, który został uchwycony przez n-te nawiasowe wzorzec wyszukiwania. n może mieć wartość od 0 do 99. \0 lub $0 odnoszą się do tekstu, który pasuje do całego wzorca wyszukiwania. Aby uzyskać numer częściowego wzorca wyszukiwania, nawiasy otwierające są liczone od 1, zaczynając od lewej strony. Aby użyć backslasha w zastąpieniu, musi on być podwojony "\\".

Jeśli chcesz pracować z zastąpieniem, w którym bezpośrednio po odniesieniu następuje kolejna liczba (tj. bezpośrednio po pasowaniu do wzorca wyszukiwania ma pojawić się liczba), nie możesz użyć zapisu \1 dla swojego odniesienia. Na przykład \11 mogłoby zmylić funkcję, ponieważ nie wie, czy chcesz odniesienie \1 za którym następuje liczba 1, czy tylko odniesienie \11. W tym przypadku rozwiązaniem jest użycie ${1}1. Dzięki temu zostaje utworzone izolowane odniesienie $1 i 1 pozostaje symbolem literowym.

Jeśli używasz przestarzałego modyfikatora e, ta funkcja maskuje kilka znaków (tj. ', ", \ i NULL) w ciągach znaków, którymi zastępuje się odniesienia. To jest robione, aby upewnić się, że nie powstają błędy składniowe, gdy używane są odniesienia zawierające pojedyncze lub podwójne cudzysłowia. Upewnij się, że znasz składnię ciągów znaków, aby wiedzieć, jak wygląda oczywiście oczywista ciąg znaków.

Wejście SUBJECT

Wejście definiuje ciąg znaków do przeszukiwania.

Wejście LIMIT

Maksymalna możliwa liczba zastosowań dla każdego wzorca w każdym subject. Domyślna wartość: -1 lub NULL (brak limitu).

Wyjście Q

Jeśli znaleziono pasujące, nowy ciąg znaków Q zostanie zwrócony, w przeciwnym razie SUBJECT zostanie zwrócone niezmienione lub NULL, jeśli wystąpił błąd.

Wyjście COUNT

Wyjście zwraca liczbę wykonanych zastosowań.