WordPress как на ладони
Недорогой хостинг для сайтов на WordPress: wordpress.jino.ru

wp_parse_list() WP 5.1.0

Разбивает строку на массив значений разделенных символами , \t\n: запятая, пробел, табуляция, перенос строки.

Пустые значения полученного массива удаляются.

Если передать массив, то он будет возвращен без изменений. Т.е. функция обрабатывает только переданные строки.

Используйте wp_parse_id_list(), когда нужно забить строку с числами, на массив чисел.

1 раз — 0.000001 сек (скорость света) | 50000 раз — 0.04 сек (скорость света) | PHP 7.2.16, WP 5.1.1

Хуков нет.

Возвращает

Массив. Значения полученные из строки.

Использование

wp_parse_list( $list );
$list(массив/строка) (обязательный)
Список значений разделенных запятыми или пробелами. Если передать массив, то он вернётся без изменений.

Примеры

#1 Демонстрация работы

$str_ids = ',1  2  , foo   4 bar,   6';
$ids = wp_parse_list( $str_ids );

/*
Array
(
	[0] => 1
	[1] => 2
	[2] => foo
	[3] => 4
	[4] => bar
	[5] => 6
)
*/
$str  = 'M-11, М-11 some:val «Москва - Санкт-Петербург», Вышний Волочек, Газель';
$list = wp_parse_list( $str );

/*
Array
(
	[0] => M-11
	[1] => М-11
	[2] => some:val
	[3] => «Москва
	[4] => -
	[5] => Санкт-Петербург»
	[6] => Вышний
	[7] => Волочек
	[8] => Газель
)
*/
$str  = '
Первая строка
Вторая
Третья
';
$list = wp_parse_list( $str );

/*
Array
(
	[0] => Первая
	[1] => строка
	[2] => Вторая
	[3] => Третья
)
*/

Строка без данных или пустая строка:

$ids = wp_parse_list( ',' ); // array( )
$ids = wp_parse_list( '' );  // array( )

Массив вернётся без изменений:

$arr = [ 'foo', 5, '', 'bar' ];
$parsed = wp_parse_list( $arr );

/*
Array
(
	[0] => foo
	[1] => 5
	[2] =>
	[3] => bar
)
*/

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

С версии 5.1.0 Введена.

Код wp_parse_list() WP 5.7.2

<?php
function wp_parse_list( $list ) {
	if ( ! is_array( $list ) ) {
		return preg_split( '/[\s,]+/', $list, -1, PREG_SPLIT_NO_EMPTY );
	}

	return $list;
}

Из раздела: Вспомогательные

Комментариев нет
    Войти