wp_parse_list( mixed[]|string $input_list ): array

Converts a comma- or space-separated list of scalar values to an array.

Parameters

$input_listmixed[]|stringrequired: List of values.

Return

array Array of scalar values. A string is split into a list, while an array keeps its keys, so the result is not necessarily a list.

Source

function wp_parse_list( $input_list ): array {
	if ( ! is_array( $input_list ) ) {
		$parsed_list = preg_split( '/[\s,]+/', $input_list, -1, PREG_SPLIT_NO_EMPTY );
		return is_array( $parsed_list ) ? $parsed_list : array();
	}

	// Validate all entries of the list are scalar.
	$input_list = array_filter( $input_list, 'is_scalar' );

	return $input_list;
}

View all references View on Trac View on GitHub

Used by	Description
WP_Theme::get_block_patterns()`wp-includes/class-wp-theme.php`	Gets block pattern data for a specified theme.
WP_REST_Pattern_Directory_Controller::get_transient_key()`wp-includes/rest-api/endpoints/class-wp-rest-pattern-directory-controller.php`	Include a hash of the query args, so that different requests are stored in separate caches.
WP_REST_Menu_Items_Controller::get_item_schema()`wp-includes/rest-api/endpoints/class-wp-rest-menu-items-controller.php`	Retrieves the nav menu item’s schema, conforming to JSON Schema.
rest_sanitize_array()`wp-includes/rest-api.php`	Converts an array-like value to an array.
rest_is_array()`wp-includes/rest-api.php`	Determines if a given value is array-like.
rest_parse_embed_param()`wp-includes/rest-api.php`	Parses the “_embed” parameter into the list of resources to embed.
WP_REST_Controller::get_fields_for_response()`wp-includes/rest-api/endpoints/class-wp-rest-controller.php`	Gets an array of fields to be included on the response.
rest_filter_response_fields()`wp-includes/rest-api.php`	Filters the REST API response to include only an allow-listed set of response object fields.
wp_parse_slug_list()`wp-includes/functions.php`	Cleans up an array, comma- or space-separated list of slugs.
WP_REST_Server::get_index()`wp-includes/rest-api/class-wp-rest-server.php`	Retrieves the site index.
WP_Comment_Query::get_comment_ids()`wp-includes/class-wp-comment-query.php`	Used internally to get a list of comment IDs matching the query vars.
wp_parse_id_list()`wp-includes/functions.php`	Cleans up an array, comma- or space-separated list of IDs.
get_pages()`wp-includes/post.php`	Retrieves an array of pages (or hierarchical post type items).

Show 8 more Show less

Changelog

Version	Description
5.1.0	Introduced.

User Contributed Notes

Skip to note 2 content

rabmalin 2 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Example:
```
$string = 'apple, banana, cherry';
$items = wp_parse_list( $string );
print_r( $items );
```
Output:
```
Array
(
    [0] => apple
    [1] => banana
    [2] => cherry
)
```
Log in to add feedback

You must log in before being able to contribute a note or feedback.