explode

(PHP 3, PHP 4, PHP 5)

explode - Разбивает строку на подстроки

Описание

array explode ( string separator, string string [, int limit] )

Возвращает массив строк, полученных разбиением строки string с использованием separator в качестве разделителя. Если передан аргумент limit, массив будет содержать максимум limit элементов, при этом последний элемент будет содержать остаток строки string. Если аргумент limit является положительным, возвращаемый массив будет содержать максимум limit элементов, при этом последний элемент будет содержать остаток строки string.
Если параметр limit отрицателен, то будут возвращены все компоненты кроме последних -limit.
Если limit равен нулю, то он расценивается как 1.

Если separator - пустая строка (""), explode() возвращает FALSE. Если separator не содержится в string, то explode() возвращает массив, содержащий один элемент string.

По историческим причинам, функции implode() можно передавать аргументы в любом порядке, но для explode() это недопустимо. separator всегда должен содержать разделитель, а string - исходную строку.

Замечание: Аргумент limit был добавлен в PHP 4.0.1
Добавлена поддержка отрицательных значений limit в PHP 5.1.0

Пример 1. Пример применения explode()

$pizza  = "piece1 piece2 piece3 piece4 piece5 piece6";
$pieces = explode(" ", $pizza);
echo $pieces[0]; // piece1
echo $pieces[1]; // piece2

Пример 2. Пример применения explode()

$data = "foo:*:1023:1000::/home/foo:/bin/sh";
list($user, $pass, $uid, $gid, $gecos, $home, $shell) = explode(":", $data);
echo $user; // foo
echo $pass; // *

Пример 3. Примеры с использованием параметра limit

$str = 'один|два|три|четыре';

// положительный лимит
print_r(explode('|', $str, 2));

// отрицательный лимит (начиная с PHP 5.1)
print_r(explode('|', $str, -1));

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

Array
(
[0] => один
[1] => два|три|четыре
)
Array
(
[0] => один
[1] => два
[2] => три
)

Замечание: Эта функция безопасна для обработки данных в двоичной форме.

Смотрите также описание функций preg_split(), spliti(), list(), split() и implode().

Все функции строки
Все функции array
Описание на ru2.php.net
Описание на php.ru