_wp_array_get( array $array, array $path, mixed $default = null )

This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness.

Accesses an array in depth based on a path of keys.

Description

It is the PHP equivalent of JavaScript’s lodash.get() and mirroring it may help other components retain some symmetry between client and server implementations.

Example usage:

$array = array(
    'a' => array(
        'b' => array(
            'c' => 1,
        ),
    ),
);
_wp_array_get( $array, array( 'a', 'b', 'c' ) );

Parameters

$array

(array) (Required) An array from which we want to retrieve some information.

$path

(array) (Required) An array of keys describing the path with which to retrieve information.

$default

(mixed) (Optional) The return value if the path does not exist within the array, or if $array or $path are not arrays.

Default value: null

Return

(mixed) The value from the path specified.

Source

File: wp-includes/functions.php 

function _wp_array_get( $array, $path, $default = null ) {
	// Confirm $path is valid.
	if ( ! is_array( $path ) || 0 === count( $path ) ) {
		return $default;
	}

	foreach ( $path as $path_element ) {
		if (
			! is_array( $array ) ||
			( ! is_string( $path_element ) && ! is_integer( $path_element ) && ! is_null( $path_element ) ) ||
			! array_key_exists( $path_element, $array )
		) {
			return $default;
		}
		$array = $array[ $path_element ];
	}

	return $array;
}

Used By

Used By Description
wp-includes/class-wp-theme-json-resolver.php: WP_Theme_JSON_Resolver::translate()

Given a theme.json structure modifies it in place to update certain values by its translated strings according to the language set by the user.
wp-includes/class-wp-theme-json.php: WP_Theme_JSON::compute_theme_vars()

Given an array of settings, it extracts the CSS Custom Properties for the custom values and adds them to the $declarations array following the format:
wp-includes/class-wp-theme-json.php: WP_Theme_JSON::get_property_value()

Returns the style property for the given path.
wp-includes/class-wp-theme-json.php: WP_Theme_JSON::merge()

Merge new incoming data.
wp-includes/class-wp-theme-json.php: WP_Theme_JSON::__construct()

Constructor.
wp-includes/class-wp-theme-json.php: WP_Theme_JSON::get_block_styles()

Converts each style section into a list of rulesets containing the block styles to be appended to the stylesheet.
wp-includes/class-wp-theme-json.php: WP_Theme_JSON::get_css_variables()

Converts each styles section into a list of rulesets to be appended to the stylesheet.
wp-includes/class-wp-theme-json.php: WP_Theme_JSON::compute_preset_classes()

Given a settings array, it returns the generated rulesets for the preset classes.
wp-includes/class-wp-theme-json.php: WP_Theme_JSON::compute_preset_vars()

Given the block settings, it extracts the CSS Custom Properties for the presets and adds them to the $declarations array following the format:
wp-includes/blocks.php: block_has_support()

Checks whether the current block type supports the feature requested.
wp-includes/blocks.php: wp_migrate_old_typography_shape()

Converts typography keys declared under supports.* to supports.typography.*.

Changelog

Version Description
5.6.0 Introduced.

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