wp_parse_list() WP 5.1.0

Розбиває рядок на масив значень розділених символами , tn: кома, пробіл, табуляція, перенесення рядка.

Порожні значення отриманого масиву видаляються.

Якщо передати масив, то його буде повернено без змін. Тобто. функція обробляє лише передані рядки.

  • Використовуйте wp_parse_id_list() , коли потрібно забити рядок з числами на масив унікальних чисел.
  • Використовуйте wp_parse_slug_list() , коли потрібно забити рядок з рядками на масив унікальних рядків.
1 раз – 0.000001 сек
(швидкість світла) | 50000 разів – 0.04 сек
(швидкість світла) |
PHP 7.2.16, WP 5.1.1

Хуків немає.

Повертає

Массив. Значення, отримані з рядка.

Використання

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

Приклади

0

#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 6.0.2

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

	return $list;
}

Залишити відповідь

Ваша e-mail адреса не оприлюднюватиметься. Обов’язкові поля позначені *