WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

wp_parse_list()

wp_parse_list( array|string $input_list ): array

In this article

Back to top

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

Parameters

$input_listarray|stringrequired
List of values.

Return

array Array of values.

Source

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

	// 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 byDescription
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
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 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 moreShow less

Changelog

VersionDescription
5.1.0Introduced.

User Contributed Notes

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