12.7 Функції роботи з блоками тексту (wordwrap (), str_replace (), substr_replace (), strtr (), stripslashes (), stripcslashes (), addslashes (), addcslashes (), quotemeta (), strrev ())

12.7.1 wordwrap ()

Синтаксис:

string wordwrap (string str [, int width [, string break [, int cut]]])

Функція wordwrap () розбиває вихідний текст на рядки з певними завершаючими символами. Згідно синтаксису, ця функція розбиває блок тексту str на кілька рядків, які завершаются символами break, так, щоб в одному рядку було не більше width букв. Оскільки розбиття відбувається по межах слів, текст залишається цілком читаючим. Наприклад:

<?

   $ Str = "Вставай, країна велика";

   $ Mod_str = wordwrap ($ str, 5, "\ t");

   echo ($ mod_str);

?>

12.7.2 str_replace()

Синтаксис:

string str_replace(string from, string to string str)

Функція str_replace() замінює у вихідному рядку str одні підрядки на інші. Тобто функція замінює в рядку str всі входження підрядка from на to, і повертає результат. Ця функція може працювати з двійковими рядками.

Наприклад, якщо Ви пишете щось на зразок гостьової книги, форуму, і хочете, щоб у формі введення для виділення тесту можна було користуватися стандарными тегами HTML, Ви можете за допомогою цієї функції замінити символи, які Ви вибрали для форматування на стандартні теги НТML. Наприклад:

$txt = str_replace("[B]","<B>",$txt);

Тобто якщо Ви використовуєте для відображення тексту напівжирним шрифтом символи "[B]", Ви повинні їх замінити на символ "<B>", використовувані в НТМL.

12.7.3 substr_replace()

Синтаксис:

string substr_replace(string str, string replacement, int start [, int length])

Ця функція замінює у вихідному рядку одні підрядки на інші. Вона повертає рядок str, в якій частина від символу з позицією start і завдовжки length замінюється рядком replacement. Якщо аргумент довжини length не вказаний, заміна проводиться до кінця.

Якщо значення аргументу start позитивно, то відлік проводиться від початку рядка str, в іншому випадку – від кінця. У разі ненегативного значення length, воно вказує довжину фрагмента, який замінюється. Якщо ж воно негативно, то це – кількість символів від кінця рядка str до останнього символу фрагмента,що замінюється.

12.7.4 strtr ()

Синтаксис:

string strtr (string str, string from, string to)

string strtr (string str, array from)

Ця функція призначена для комплексної заміни в рядку і має два види синтаксису.

У першому випадку функція strtr () повертає рядок str, в якій кожен символ, присутній в рядку from, замінюється на символ з рядка to. Якщо рядки from та to різної довжини, то зайві кінцеві символи у тому рядку, який довше, ігноруються.

У другому випадку функція strtr () повертає рядок, в якому фрагменти рядка str замінюються на фрагменти, відповідні індексам значень елементів масиву from. Спочатку функція намагається замінити найбільші фрагменти початкового рядка, при цьому не виконуючи заміну в уже модифікованих частинах рядка. Таким чином, можна відразу виконати кілька замін:

<?

   $ Str = array ( "" => "M.Kuznetsov",

             "<Name2>" => "I.Simdyanov");

   $ Str_out = "Автори цього підручника і вітають вас!";

   echo strtr ($ str_out, $ str);

?>

А ось як можна за допомогою цієї функції скасувати дію функції htmlspecialchars ():

<?

   $ Var = array_flip (get_html_translation_table ());

   $ Str = strtr ($ str, $ var);

?>

Тобто, з рядка, в якій всі спецсимволи замінені на їх HTML-еквіваленти, ми отримаємо вихідний рядок.

12.7.5 stripslashes()

Синтаксис:

string stripslashes(string str)

Функція видалення зворотніх слешів. Тобто проводиться заміна в рядку str попередженням слешем символів на їх кодові еквіваленти. Функція працює з символами: ", ", \.

12.7.6 stripcslashes()

Синтаксис:

string stripcslashes(string str)

А ця функція перетворює спецсимволи в їх двійкове подання. Вона повертає рядок, в якому закоментовані зворотнім слешем спецсимволи, (з метою візуального відображення), перетворюються в їх двійкове подання. Функція розпізнає C-подібні записи (вісімкові і шістнадцяткові послідовності \n \r і т. д.).

12.7.7 addslashes().

Синтаксис:

string addslashes(string str)

Функція додавання слешів перед символами рядка "," і \. Цю функцію зручно використовувати при виклику функції eval().

12.7.8 addcslashes().

Синтаксис:

string addcslashes(string str, string charlist)

Функція додавання слешів перед спеціальними символами рядка. Повертає рядок str, в який вставлені символи зворотнього слеша перед перерахованими в списку charlist символами.

12.7.9 quotemeta()

Синтаксис:

string quotemeta(string str)

Функція цитування метасимволів. Повертає рядок, в який додані зворотні слеши перед кожним з наступних символів: . \\ + * ? [ ^ ] ( $ ). Функцію можна використовувати для підготовки шаблонів у регулярних виразах.

12.7.10 strrev().

Синтаксис:

string strrev(string str). Функція виробляє реверс рядка.