Funkce PHP preg_filter().
❮ Referenční příručka PHP RegExp
Příklad
Zabalte čísla do hranatých závorek v seznamu řetězců:
<?php
$input = [
"It is 5 o'clock",
"40 days",
"No
numbers here",
"In the year 2000"
];
$result =
preg_filter('/[0-9]+/', '($0)', $input);
print_r($result);
?>
Definice a použití
Funkce preg_filter()
vrací řetězec nebo pole řetězců, ve kterých byly shody vzoru nahrazeny náhradním řetězcem.
Pokud je vstupem pole, tato funkce vrátí pole. Pokud je vstupem řetězec, pak tato funkce vrací řetězec.
Tato funkce je podobná funkci preg_replace()
s jedním rozdílem: Pokud není ve vstupním řetězci nalezena shoda se vzorem, řetězec nebude použit ve vrácené hodnotě. V tomto scénáři, pokud je vstupem řetězec namísto pole, funkce vrátí hodnotu null .
Náhradní řetězce mohou obsahovat zpětné odkazy ve tvaru \n nebo $n, kde n je index skupiny ve vzoru. Ve vráceném řetězci budou instance \n a $n nahrazeny podřetězcem, který odpovídal skupině nebo, pokud jsou použity \0 nebo $0, celým výrazem.
Syntax
preg_filter(pattern, replacement, input, limit, count)
Hodnoty parametrů
Parameter | Description |
---|---|
pattern | Required. Contains a regular expression indicating what to search for |
replacement | Required. A string which will replace the matched patterns. It may contain backreferences |
input | Required. A string or array of strings in which the replacements are being performed |
limit | Optional. Defaults to -1, meaning unlimited. Sets a limit to how many replacements can be done in each string |
count | Optional. After the function has executed, this variable will contain a number indicating how many replacements were performed |
Technické údaje
Návratová hodnota: | Vrátí pole nahrazených řetězců, pokud vstupem bylo pole, řetězec s nahrazením, pokud byl vstupem řetězec, nebo null, pokud vstupem byl řetězec a nebyly nalezeny žádné shody |
---|---|
Verze PHP: | 5.3.0 |
❮ Referenční příručka PHP RegExp