wp_is_numeric_array( mixed $data ): bool

Determines if the variable is a numeric-indexed array.

Description

Note! This answers a different question than array_is_list() and is more flexible to handle situations where some numeric array indices have been removed. A numeric-indexed array is only a “list” when the array keys form a contiguous range from zero to the highest key.

Example:

true  === wp_is_numeric_array( array( 1, 2, 3, 4 ) );
false === wp_is_numeric_array( array( 'name' => 'WordPress' ) );

// All-numeric keys vs. list.
$above_two   = array_filter( array( 1, 2, 8, 9 ), fn ( $v ) => $v > 2 );
$above_two === array( '2' => 8, '3' => 9 );
true       === wp_is_numeric_array( $above_two );
false      === array_is_list( $above_two );

Parameters

$datamixedrequired: Variable to check.

Return

bool Whether the variable is a list.

Source

function wp_is_numeric_array( $data ): bool {
	if ( ! is_array( $data ) ) {
		return false;
	}

	return array_all( $data, fn( $value, $key ) => ! is_string( $key ) );
}

View all references View on Trac View on GitHub

Used by	Description
_wp_prepare_json_schema_for_client_with_allowed_keywords()`wp-includes/json-schema.php`	Prepares a JSON Schema for clients using a given keyword lookup.
wp_cache_switch_to_blog_fallback()`wp-includes/ms-blogs.php`	Fallback logic for switching cache context when an object cache drop-in lacks a switch_to_blog() method.
WP_Font_Utils::sanitize_from_schema()`wp-includes/fonts/class-wp-font-utils.php`	Sanitizes a tree of data using a schema.
WP_Theme_JSON::remove_keys_not_in_schema()`wp-includes/class-wp-theme-json.php`	Given a tree, removes the keys that are not present in the schema.
get_metadata_default()`wp-includes/meta.php`	Retrieves default metadata value for the specified meta key and object.
rest_is_array()`wp-includes/rest-api.php`	Determines if a given value is array-like.
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_REST_Server::response_to_data()`wp-includes/rest-api/class-wp-rest-server.php`	Converts a response to data to send.
WP_Roles::add_role()`wp-includes/class-wp-roles.php`	Adds a role name with capabilities to the list.
wp_count_terms()`wp-includes/taxonomy.php`	Counts how many terms are in taxonomy.

Show 5 more Show less

Changelog

Version	Description
4.4.0	Introduced.

User Contributed Notes

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