spliti - Разбивает строку в массив с помощью регулярного выражения без учета регистра
Вернуться к: Функции регулярных выражений POSIX
spliti
(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.
Функция spliti() является устаревшей начиная с PHP 5.3.0.
Предлагается использовать вместо неё функцию preg_split()
с модификатором i (PCRE_CASELESS
).
Смотрите также
- preg_split() - Разбивает строку по регулярному выражению
- split() - Разбиение строки на массив по регулярному выражению
- explode() - Разбивает строку с помощью разделителя
- implode() - Объединяет элементы массива в строку
Вернуться к: Функции регулярных выражений POSIX