Docs4dev
Docs
wordpress / latest / functions / wp_parse_list.html

wp_parse_list( array|string $list ): array

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

Parameters

$list array|string Required
List of values.

Return

array Array of values.

Source

File: wp-includes/functions.php. View all references

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

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

	return $list;
}

Used By

Used By Description
WP_REST_Pattern_Directory_Controller::get_transient_key() wp-includes/rest-api/endpoints/class-wp-rest-pattern-directory-controller.php
WP_REST_Menu_Items_Controller::get_item_schema() wp-includes/rest-api/endpoints/class-wp-rest-menu-items-controller.php

Retrieves the term’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 a white-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_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).

Changelog

Version Description
5.1.0 Introduced.

© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/wp_parse_list