_wp_array_set() - Sets an array in depth based on a path of keys.

_wp_array_set() – Sets an array in depth based on a path of keys.

You appear to be a bot. Output may be restricted

Description

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

It is the PHP equivalent of JavaScript's lodash.set() and mirroring it may help other components retain some symmetry between client and server implementations. Example usage:

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

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

Usage

_wp_array_set( $array, $path, $value );

Parameters

$array: ( array ) required – An array that we want to mutate to include a specific value in a path.
$path: ( array ) required – An array of keys describing the path that we want to mutate.
$value: ( mixed ) optional – The value that will be set.

Returns

void

Source

File name: wordpress/wp-includes/functions.php
Lines:

1 to 39 of 39

function _wp_array_set( &$array, $path, $value = null ) {
  // Confirm $array is valid.
  if ( ! is_array( $array ) ) {
    return;
  }

  // Confirm $path is valid.
  if ( ! is_array( $path ) ) {
    return;
  }

  $path_length = count( $path );

  if ( 0 === $path_length ) {
    return;
  }

  foreach ( $path as $path_element ) {
    if (
      ! is_string( $path_element ) && ! is_integer( $path_element ) &&
      ! is_null( $path_element )
    ) {
      return;
    }
  }

  for ( $i = 0; $i < $path_length - 1; ++$i ) {
    $path_element = $path[ $i ];
    if (
      ! array_key_exists( $path_element, $array ) ||
      ! is_array( $array[ $path_element ] )
    ) {
      $array[ $path_element ] = array();
    }
    $array = &$array[ $path_element ]; // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.VariableRedeclaration
  }

  $array[ $path[ $i ] ] = $value;
}

View on GitHub View on Trac