strtr
Преобразовывает символы или заменяет подстроки
&reftitle.description;
stringstrtr
stringstring
stringfrom
stringto
Альтернативная сигнатура (не поддерживается с именованными аргументами):
stringstrtr
stringstring
arrayreplace_pairs
Если указали три аргумента, функция возвращает копию
строки string, в которой все вхождения каждого
символа (однобайтного) из значения from функция заменила
на соответствующий символ в параметре to,
то есть каждое вхождение из $from[$n] заменяется
на $to[$n], где $n —
корректное смещение строки в обоих аргументах.
Если длины строк from и
to отличаются, «лишние» символы в более
длинной строке не используются. Длина возвращаемого значения
будет такой же, как и длина string.
Функцию strtr разрешается вызывать с двумя аргументами.
Тогда параметр from должен быть массивом
(array), в формате
array('from' => 'to', ...). Функция вернёт
строку, в которой заменит каждый ключ массива значениями, которые соответствуют ключам.
Функция strtr в первую очередь заменяет более
длинные ключи, причём одна и та же строка поиска используется
только один раз.
Тогда ключи и значения могут иметь любую длину,
за исключением того, что ключи не должны быть пустыми. Кроме того,
длина возвращаемого значения может отличаться от
string.
Однако стоит учесть тот факт, что эта функция максимально
эффективна тогда, когда все ключи имеют одинаковый размер.
&reftitle.parameters;
string
Заменяемая строка (string).
from
Строка (string), которую функция заменит на строку to.
to
Строка (string), которая заменяет строку from.
replace_pairs
Параметр replace_pairs может быть
использован вместо to и from,
в этом случае он является массивом (array) и имеет
форму array('from' => 'to', ...).
Если параметр replace_pairs содержит ключ в виде пустой
строки (string) (""), элемент игнорируется;
начиная с PHP 8.0.0 в таком случае выдаётся ошибка уровня E_WARNING.
&reftitle.returnvalues;
Функция возвращает преобразованную строку (string).
&reftitle.examples;
Пример использования функции strtr
]]>
Следующий пример демонстрирует поведение функции strtr
при вызове только с двумя аргументами. Обратите внимание на
приоритет замен ("h" не используется, так как
существуют более длинные совпадения) и как заменённый текст
больше не участвует в поиске.
Пример использования функции strtr с двумя аргументами
"-", "hello" => "hi", "hi" => "hello");
echo strtr("hi all, I said hello", $trans);
?>
]]>
&example.outputs;
Эти два режима довольно сильно различаются. При вызове
функции strtr с тремя аргументами заменяются байты,
а при вызове с двумя аргументами могут быть заменены и
более длинные подстроки.
Сравнение поведения функции strtr
"01");
echo strtr("baab", $trans);
?>
]]>
&example.outputs;
&reftitle.seealso;
str_replace
preg_replace