strtr

(PHP 4, PHP 5, PHP 7, PHP 8)

strtr — Перетворює задані символи або замінює підрядки

Опис

strtr(string $string, string $from, string $to): string

Альтернативна сигнатура (не підтримується з іменованими аргументами):

strtr(string $string, array $replace_pairs): string

Якщо вказано три аргументи, ця функція повертає копію string, в якій всі входження кожного символу (однобайтного) з from були замінені на відповідний символ у параметрі to, то есть каждое вхождение из$from[$n]заменяется на$to[$n], где$n - це коректне усунення рядка в обох аргументах.

Якщо довжина рядків fromиto відрізняються, "зайві" символи у довшому рядку не використовуються. Довжина значення, що повертається, буде такою ж, як і довжина string

strtr() може викликатися із двома аргументами. В цьому випадку from має бути масивом (array), у формі array('from' => 'to', ...). Функція поверне рядок, у якому всі ключі масиву замінять їх елементами . strtr() в першу чергу замінює довші ключі, причому один і той же рядок пошуку використовується лише один раз.

У цьому випадку ключі та значення можуть мати будь-яку довжину, за винятком того, що ключі не повинні бути порожніми. Крім того, довжина значення, що повертається, може відрізнятися від string. Однак, варто врахувати той факт, що ця функція є максимально ефективною в тому випадку, якщо всі ключі мають однаковий розмір.

Список параметрів

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

Значення, що повертаються

Повертає рядок (string) із проведеними у ньому замінами.

Приклади

Приклад #1 Приклад використання strtr()****

Loading...
▶

Следующий Приклад демонстрирует поведение функцииstrtr() при виклику лише з двома аргументами. Зверніть увагу на пріоритет замін ("h" не використовується, тому що існують довші збіги) і як замінений текст більше не бере участі в пошуку.

Приклад #2 Приклад використання strtr()** з двома аргументами**

Loading...
▶

Результат виконання наведеного прикладу:

hello all, I said hi

Ці два режими досить сильно відрізняються. При виклику strtr() з трьома аргументами замінюються байти, а при виклику з двома аргументами можуть бути замінені і довші підрядки.

Приклад #3 Сравнение поведения функцииstrtr()****

Loading...
▶

Результат виконання наведеного прикладу:

1001
ba01

Дивіться також

• str_replace() - Замінює всі входження рядка пошуку на рядок заміни
• preg_replace() - Виконує пошук та заміну за регулярним виразом