(PHP 4 >= 4.0.1, PHP 5)
spliti — Разбивает строку в массив с помощью регулярного выражения без учета регистра
$pattern
, string $string
[, int $limit
= -1
] )
Разбивает строку string
в массив с помощью регулярного выражения.
Эта функция идентична функции split() за исключением того, что она игнорирует регистр символов при сравнении.
С версии PHP 5.3.0 эта функция считается УСТАРЕВШЕЙ. Крайне не рекомендуется полагаться на эту возможность.
pattern
Регистронезависимое регулярное выражение.
Если вы хотите разделить строку по символам, которые являются специальными символами регулярного выражения, вам сначала нужно заэкранировать эти символы. Если вы думаете, что функция spliti() (или другая функция для работы с регулярными выражениями) делает что-то странное, пожалуйста, прочитайте файл regex.7, который находится в папке regex/ дитсрибутива PHP. Этот файл находится в формате manpage, поэтому вы можете прочитать его коммандой man /usr/local/src/regex/regex.7.
string
Строка для разделения.
limit
Если установлен limit
, возвращаемый массив
будет содержать максимум limit
элементов,
в котором последний элемент содержит
всю строку string
.
Возвращает массив строк, каждая из которых является подстрокой
строки string
, образованный с помощью
регистронезависимого разделения регулярным выражением pattern
.
Если встречаются n вхождений pattern
,
возвращаемый массив будет содержать n+1
элементов. К примеру, если вхождений pattern
не будет
найдено, то будет возвращен массив только с одним элементом.
Естественно, это также справедливо, если string
пустая. Если в процессе возникает ошибка,
spliti() возвращает FALSE
.
Разделение строки, используя 'a' как разделитель:
Пример #1 Пример spliti()
<?php
$string = "aBBBaCCCADDDaEEEaGGGA";
$chunks = spliti ("a", $string, 5);
print_r($chunks);
?>
Результат выполнения данного примера:
Array ( [0] => [1] => BBB [2] => CCC [3] => DDD [4] => EEEaGGGA )
Замечание:
С версии PHP 5.3.0, расширение regex помечено устаревшим и заменено расширением PCRE. Вызов этой функции приведет к ошибке уровня
E_DEPRECATED
. Смотрите список отличий для помощи при конвертировании в PCRE.