Split - Розбиття рядка на масив за регулярним виразом, Посібник з PHP
split — Розбиття рядка на масив за регулярним виразом
Розбиває рядок string на масив за регулярним виразом.
З версії PHP 5.3.0 ця функція вважається застарілою. Вкрай не рекомендується покладатися на цю можливість.
Список параметрів
Регулярний вираз, чутливий до регістру.
Якщо потрібно розбити рядок за символами, які є спеціальними для регулярних виразів, їх слід екранувати. Якщо вам здається, що split() (або будь-яка інша функція, що працює з регулярними виразами) поводиться несподівано, будь ласка, прочитайте файл regex.7 , розташований в піддиректорії regex/ дистрибутива PHP. Він збережений у форматі manpage, тому для зручності читання використовуйте команду man /usr/local/src/regex/regex.7.
Якщо вказано параметр limit , повертається масив буде містити максимум limit елементів, причому останній елемент буде включати всю частину рядка string , що залишилася .
Значення, що повертаються
Повертає масив рядків, кожен з яких є рядком, утвореним розбиттям рядка string чутливим до регістру регулярним виразом pattern .
Якщо pattern зустрічається n разів, результуючий масив міститиме n +1 елементів. Наприклад, якщо pattern у рядку відсутня, буде повернено масив, що містить 1 елемент. Зрозуміло, це також вірно у випадку, коли string є порожнім рядком. У разі помилкиsplit() повертаєFALSE.
Приклад #1 Приклад використанняsplit()
Отримуємо перші чотири поля рядка з /etc/passwd :
Приклад #2 Приклад використанняsplit()
Розпізнаємо дату, відформатовану з використанням слішів, точок абодефісів:
Примітки
З версії PHP 5.3.0, розширення regex позначено застарілим та замінено розширенням PCRE. Виклик цієї функції призведе до помилки рівняE_DEPRECATED. Дивіться список відмінностей для конвертування в PCRE.
Функціяsplit() є застарілою починаючи з PHP 5.3.0. Пропонується використовувати замість неї функцію preg_split(). Якщо немає необхідності використовувати регулярні вирази, ефективніше використовувати explode() , яка не використовує додаткові ресурси для розбирання регулярного виразу.
Користувачам, яким необхідно емулювати поведінку @chars = split('', $str) з Perl, слід звернутися до прикладів preg_split() або str_split() .
Дивіться також
- preg_split() - Розбиває рядок за регулярним виразом
- spliti() - Розбиває рядок у масив за допомогою регулярного виразу без урахування регістру
- str_split() - Перетворює рядок на масив
- explode() - Розбиває рядок за допомогою роздільника
- implode() - Об'єднує елементи масиву в рядок
- chunk_split() - Розбиває рядок на фрагменти
- wordwrap() - Переносить рядок за вказаною кількістю символів