<?php/**

* Created by PhpStorm.

* User: ZHOUZ

* Date: 14-5-25

* Time: 下午5:32

*/namespace Snail\Component;/**

* 多維數(shù)組節(jié)點讀寫

* Class Node

*@package Snail\Component

*/class Node extends AComponent{    /**

    * 多維數(shù)組節(jié)點分隔符

    *@var string

    */    const SP = '.';

    /**

    * 將非字符串類型數(shù)據(jù)生成字符串節(jié)點

    * <code>

    * Node::create(array('a', 'b', 1, true)) => 'a.b.1.1'

    * Node::create('a', 'b', null, false)    => 'a.b'

    * </code>

    *@param mixed $nodes 支持?jǐn)?shù)組、任意參數(shù)個數(shù)

    *@return string

    */   
 public static function create($nodes)
 {      
      ! is_array($nodes) && $nodes = func_get_args();
      return join(static::SP, array_filter(array_map('strval', $nodes)));
  }

    /**

    * 獲取多維數(shù)組節(jié)點轉(zhuǎn)化為數(shù)組鍵名

    *@param string $node

    *@return array

    */  
     public static function explode($node)
     {       
             return explode(static::SP, $node);
     }

    /**

    * 設(shè)置多維數(shù)組節(jié)點值

    * 注意：

    * 由于 PHP 數(shù)組數(shù)值鍵名長度只支持 int 的最大長度分瘾，

    * 為避免出現(xiàn)覆蓋等混亂現(xiàn)象胎围，所有節(jié)點在轉(zhuǎn)化為鍵名時都將

    * 強制被轉(zhuǎn)換為字符串類型

    *@param array & $arr 引用被操作數(shù)組的內(nèi)存地址

    *@param string $node 節(jié)點路徑, 如: a.b.c => $arr['a']['b']['c'];

    *@param mixed $value

    *@return void

    */    public static function set(array & $arr, $node, $value = null) {        $arr = $arr2 = (array) $arr;

        $keys = static::explode($node);

        foreach ($keys as $key) {

            $key = strval($key);

            if (isset($arr[$key])) {

                $arr = & $arr[$key];

            } else {

                $arr[$key] = array();

                $arr = & $arr[$key];

            }

        }

        $arr = $value;

    }

    /**

    * 獲取多維數(shù)組指定節(jié)點值

    *@param array & $arr 引用被操作數(shù)組的內(nèi)存地址

    *@param string $node 節(jié)點路徑, 如: a.b.c => $arr['a']['b']['c'];

    *@param null|mixed $default 若節(jié)點不存在時返回該默認(rèn)值

    *@return mixed

    */    public static function get(array & $arr, $node, $default = null) {        if (empty($arr)) return $default;

        $keys = static::explode($node);

        foreach ($keys as $key) {

            $key = strval($key);

            if (isset($arr[$key])) {

                $arr = & $arr[$key];

            } else {

                return $default;

            }

        }

        return $arr;

    }

    /**

    * 將第二個多維數(shù)組覆蓋或添加到第一個多維數(shù)組進(jìn)行合并

    *@param array & $arraySrc 引用被更新的數(shù)組

    *@param array & $arrayReplace 引用需要合并的數(shù)據(jù)

    *@return void 地址操作無返回值

    */    public static function merge(array & $arraySrc, array & $arrayReplace) {        if (empty($arrayReplace)) return;

        foreach ($arrayReplace as $k=>& $v) {

            if (is_array($v) && isset($arraySrc[$k])) {

                static::merge($arraySrc[$k], $v);

            } else {

                $arraySrc[$k] = $v;

            }

        }

    }

    /**

    * 判斷多維數(shù)組中是否存在指定節(jié)點,

    * 結(jié)果同 isset 關(guān)鍵字 (若存在鍵但值為 NULL 則也會返回 false)

    *@param array & $arr 引用原數(shù)組

    *@param string $node

    *@return bool

    */    public static function has(array & $arr, $node) {        if (empty($arr)) return false;

        $keys = static::explode($node);

        foreach ($keys as $key) {

            $key = strval($key);

            if (isset($arr[$key])) {

                $arr = & $arr[$key];

            } else {

                return false;

            }

        }

        return true;

    }

    /**

    * 判斷多維數(shù)組中是否存在指定鍵

    *@param array & $arr 引用原數(shù)組

    *@param string $node

    *@return bool

    */    public static function hasKey(array & $arr, $node) {        if (empty($arr)) return false;

        $keys = static::explode($node);

        foreach ($keys as $key) {

            $key = strval($key);

            if (array_key_exists($key, $arr)) {

                $arr = & $arr[$key];

            } else {

                return false;

            }

        }

        return true;

    }

    /**

    * 注銷數(shù)組中的指定節(jié)點元素

    *@param array $arr

    *@param string $node

    *@return void

    */    public static function clear(array & $arr, $node) {        if (empty($arr)) return;

        $keys = static::explode($node);

        foreach ($keys as $key) {

            $key = strval($key);

            if (isset($arr[$key])) {

                $arr = & $arr[$key];

            } else {

                return; // 指定節(jié)點不存在亦認(rèn)為是成功            }

        }

        $arr = null;

        unset($arr);

    }

}