Blok funkce PREG_REPLACE

Blok funkce PREG_REPLACE hledá a nahrazuje pomocí regulárních výrazů.

Poznámka: Tato funkce je Binary-Safe. To znamená, že znaky UTF8 nelze přímo upravovat.

Vstup PATTERN

Výraz jako řetězec, podle kterého se hledá. K dispozici jsou také některé PCRE modifikátory.

Vstup REPLACEMENT

Řetězec pro nahrazení. Může obsahovat reference ve tvaru \n nebo $n, přičemž druhé je přednostní. Každá z těchto referencí se nahrazuje textem, který byl zachycen n-tým vloženým vzorem hledání. n může mít hodnotu od 0 do 99. \0 nebo $0 se vztahují na text, který odpovídá celému vzoru hledání. Pro získání čísla zachycujícího podvzoru se počítají otevřené závorky s 1 začínající odleva doprava. Pro použití zpětného lomítka v nahrazení musí být zdvojené "\\".

Pokud chcete pracovat s nahrazením, ve kterém na odkazování zpět ihned následuje další číslo (tj. ihned po shodě s vzorem hledání má následovat číslo), nemůžete pro své odkazování zpět použít zápis \1. Například by \11 zmátlo funkci, protože neví, zda chcete odkazování zpět \1 následované číslem 1, nebo jen odkazování zpět \11. V tomto případě je řešením použití ${1}1. Tím se vytvoří izolované odkazování zpět $1 a 1 zůstane znakem.

Pokud používáte zastaralý modifikátor e, tato funkce maskuje několik znaků (konkrétně ', ", \ a NULL) v řetězcích, kterými se nahrazují odkazování zpět. To se dělá za účelem zajištění, aby nedošlo k chybám syntaxe při použití odkazování zpět obsahujících jednoduché nebo dvojité uvozovky. Ujistěte se, že znáte syntaxi řetězců, abyste přesně věděli, jak vypadá vyhodnocený řetězec.

Vstup SUBJECT

Vstup definuje řetězec k prohledávání.

Vstup LIMIT

Maximální počet možných nahrazení pro každý vzor v každém subjektu. Výchozí hodnota: -1 nebo NULL (žádné omezení).

Výstup Q

Pokud byly nalezeny shody, vrátí se nový řetězec Q, jinak se vrátí SUBJECT nezměněný nebo NULL, pokud došlo k chybě.

Výstup COUNT

Výstup vrací počet provedených nahrazení.