Функция wp_parse_list() предназначена для преобразования списка значений, разделенных запятыми или пробелами, в массив. Это полезно для обработки данных, полученных из форм, URL или других источников, где значения представлены в виде строки.
wp_parse_list( array|string $input_list ): array
Параметры
$input_list(array|string, обязательный) – Список значений, который может быть представлен как строка, разделенная запятыми или пробелами, или как массив значений.
Возвращаемое значение
Функция возвращает массив, содержащий значения, полученные из входной строки.
Пример 1: Преобразование строки с фруктами
В этом примере мы передаем строку с названиями фруктов, разделенными запятыми.
$string = 'apple, banana, cherry';
$items = wp_parse_list($string);
print_r($items);
/*
Array
(
[0] => apple
[1] => banana
[2] => cherry
)
*/
Пример 2: Обработка строки с различными разделителями
Функция может обрабатывать строки с разными разделителями, включая пробелы и символы переноса строки.
$str_ids = ",1 2 , orange 4 grape, 6 \n /fruit/peach \r\n !@#$ \t tab";
$ids = wp_parse_list($str_ids);
print_r($ids);
/*
Array
(
[0] => 1
[1] => 2
[2] => orange
[3] => 4
[4] => grape
[5] => 6
[6] => /fruit/peach
[7] => !@#$
[8] => tab
)
*/
Пример 3: Преобразование многострочной строки
Функция эффективно разбивает многострочные данные на отдельные элементы.
$str = '
Первая строка
Вторая строка
Третья строка
';
$list = wp_parse_list($str);
print_r($list);
/*
Array
(
[0] => Первая
[1] => строка
[2] => Вторая
[3] => строка
[4] => Третья
[5] => строка
)
*/
Пример 4: Обработка пустых значений
Если передать строку без данных или пустую строку, функция вернет пустой массив.
$empty_ids = wp_parse_list(',');
print_r($empty_ids); // Array()
$empty_ids = wp_parse_list('');
print_r($empty_ids); // Array()
Пример 5: Работа с массивом
Если передать массив, он будет возвращен без изменений.
$arr = ['apple', 3, '', 'banana'];
$parsed = wp_parse_list($arr);
print_r($parsed);
/*
Array
(
[0] => apple
[1] => 3
[2] =>
[3] => banana
)
*/
Пример 6: Сложный пример со строками
В этом примере мы преобразуем строку, содержащую сложные значения.
$str = 'page-1, page-2, page-3, section 4, section 5 - details';
$list = wp_parse_list($str);
print_r($list);
/*
Array
(
[0] => page-1
[1] => page-2
[2] => page-3
[3] => section
[4] => 4
[5] => section
[6] => 5
[7] => -
[8] => details
)
*/
Заключение
Функция wp_parse_list() в WordPress является полезным инструментом для преобразования строковых данных в массив. Она позволяет легко обрабатывать списки значений, извлекая их и очищая от лишних пробелов и пустых значений. Благодаря своей универсальности и простоте использования, эта функция может значительно упростить работу с данными в ваших проектах на WordPress.