explode

(PHP 4, PHP 5, PHP 7)

explodeРазбивает строку с помощью разделителя

Описание

array explode ( string $delimiter , string $string [, int $limit ] )

Возвращает массив строк, полученных разбиением строки string с использованием delimiter в качестве разделителя.

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

delimiter

Разделитель.

string

Входная строка.

limit

Если аргумент limit является положительным, возвращаемый массив будет содержать максимум limit элементов, при этом последний элемент будет содержать остаток строки string.

Если параметр limit отрицателен, то будут возвращены все компоненты кроме последних -limit.

Если limit равен нулю, то он расценивается как 1.

Замечание:

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

Возвращаемые значения

Возвращает массив (array) строк (string), созданный делением параметра string по границам, указанным параметром delimiter.

Если delimiter является пустой строкой (""), explode() возвращает FALSE. Если delimiter не содержится в string, и используется отрицательный limit, то будет возвращен пустой массив (array), иначе будет возвращен массив, содержащий string.

Список изменений

Версия Описание
5.1.0 Добавлена поддержка отрицательных значений limit

Примеры

Пример #1 Пример использования explode()

<?php
// Пример 1
$pizza  "кусок1 кусок2 кусок3 кусок4 кусок5 кусок6";
$pieces explode(" "$pizza);
echo 
$pieces[0]; // кусок1
echo $pieces[1]; // кусок2

// Пример 2
$data "foo:*:1023:1000::/home/foo:/bin/sh";
list(
$user$pass$uid$gid$gecos$home$shell) = explode(":"$data);
echo 
$user// foo
echo $pass// *

?>

Пример #2 Пример возвращаемого значения explode()

<?php
/* 
   Строка, которая не содержит разделителя, будет
   просто возвращать массив с одним значением оригинальной строки.
*/
$input1 "hello";
$input2 "hello,there";
var_dumpexplode','$input1 ) );
var_dumpexplode','$input2 ) );

?>

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

array(1)
(
    [0] => string(5) "hello"
)
array(2)
(
    [0] => string(5) "hello"
    [1] => string(5) "there"
)

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

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

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

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

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

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

Примечания

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

Смотрите также

  • preg_split() - Разбивает строку по регулярному выражению
  • str_split() - Преобразует строку в массив
  • mb_split() - Разделение строк в многобайтных кодировках, используя регулярное выражение
  • str_word_count() - Возвращает информацию о словах, входящих в строку
  • strtok() - Разбивает строку на токены
  • implode() - Объединяет элементы массива в строку

Коментарии

Автор:
Be careful, while most non-alphanumeric data types as input strings return an array with an empty string when used with a valid separator, true returns an array with the string "1"!

var_dump(explode(',', null)); //array(1) { [0]=> string(0) "" }
var_dump(explode(',', false)); //array(1) { [0]=> string(0) "" }

var_dump(explode(',', true)); //array(1) { [0]=> string(1) "1" }
2021-02-10 23:42:58
http://php5.kiev.ua/manual/ru/function.explode.html
Автор:
Note that an empty input string will still result in one element in the output array. This is something to remember when you are processing unknown input.

For example, maybe you are splitting part of a URI by forward slashes (like "articles/42/show" => ["articles", "42", "show"]). And maybe you expect that an empty URI will result in an empty array ("" => []). Instead, it will contain one element, with an empty string:

<?php

$uri 
'';
$parts explode('/'$uri);
var_dump($parts);

?>

Will output:

array(1) {
  [0]=>
  string(0) ""
}

And not:

array(0) {
}
2022-03-20 01:53:51
http://php5.kiev.ua/manual/ru/function.explode.html
Автор:
If you want to directly take a specific value without having to store it in another variable, you can implement the following:

$status = 'Missing-1';
 
echo $status_only = explode('-', $status)[0];

// Missing
2022-10-06 18:04:52
http://php5.kiev.ua/manual/ru/function.explode.html
Автор:
If your data is smaller than the expected count with the list expansion:

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

The result is a warning not an error:

PHP Warning:  Undefined array key 7 in ...

The solution is to pad the array to the expected length:

<?php
$data 
"foo:*:1023:1000::/home/foo:/bin/sh";
list(
$user$pass$uid$gid$gecos$home$shell,$nu) = array_padexplode(":"$data), 8""); 
// where 8 is the count of the list arguments
?>
2023-11-10 03:12:35
http://php5.kiev.ua/manual/ru/function.explode.html

    Поддержать сайт на родительском проекте КГБ