ginkgo\Arrays

数组处理，大部分为原 ginkgo\Func 类迁移而来

0.2.0 新增

类摘要

namespace ginkgo;

class Arrays {
  // 属性
  public static $error;

  private static $errType = array(
    JSON_ERROR_DEPTH            => 'Maximum stack depth exceeded',
    JSON_ERROR_STATE_MISMATCH   => 'State mismatch (invalid or malformed JSON)',
    JSON_ERROR_CTRL_CHAR        => 'Control character error, possibly incorrectly encoded',
    JSON_ERROR_SYNTAX           => 'Syntax error',
  );

  // 方法
  public static map( array $arr [, string $func [, int $left = 5 [, int $right = 5 [, string $hide = '*' ]]]] ) : array // since 0.2.3
  public static unique( array $arr [, bool $pop_false = false ] ) : array // since 0.2.4
  public static toJson( array $arr [, bool $func ] ) : string
  public static fromJson( string $json [, bool $assoc = true ] ) : array
  public static getError() : array

  public static each( array $arr [, string $func [, int $left = 5 [, int $right = 5 [, string $hide = '*' ]]]] ) : array // 0.2.3 起改为 map() 方法，即将弃用
  public static filter( array $arr [, bool $pop_false = false ] ) : array // 0.2.4 起改为 unique() 方法，即将弃用
}

成员目录

$errType 错误类型

private static $errType;

结构

unique() 过滤数组中的重复内容

0.2.4 起由 filter() 方法变更而来

public static function unique( array $arr [, bool $pop_false = true ] ) : array

参数

• arr 数组
• pop_false 是否去除等值为 FALSE 的条目

返回

• 过滤后的数组

map() 遍历数组，对键值进行安全过滤，并用指定的方式对键值进行编码

0.2.3 起由 each() 方法变更而来

public static function map( array $arr [, string $func [, int $left = 5 [, int $right = 5 [, string $hide = '*' ]]]] ) : array

参数

• arr 数组

• func 处理函数、方法

  可能的值

  值	描述
  空（默认值）	不作处理
  url_encode 或 urlencode	URL 编码
  url_decode 或 urldecode	URL 解码
  json_safe	用 JSON 安全的方式解码
  md5	md5 编码
  base64_encode 或 base64encode	base64 编码
  base64_decode 或 base64decode	base64 解码
  secrecy	用 Strings::secrecy() 方法处理字符
  html_encode 或 htmlencode	0.2.3 新增
  html_decode 或 htmldecode	0.2.3 新增

• left 保留左边字符数, 仅在处理函数为 secrecy 时有效

• right 保留右边边字符数, 仅在处理函数为 secrecy 时有效
• hide 替换字符, 仅在处理函数为 secrecy 时有效

返回

• 处理后的数组

toJson() 转换为 JSON

public static function toJson( array $arr [, bool $encode = false ] ) : string

参数

• arr 数组

• encode 编码方式，对待编码的数组用指定的方式对键值进行编码

  可能的值

  值	描述
  空（默认值）	不进行编码
  urlencode	URL 编码
  json_safe	用 JSON 安全的 URL 编码
  md5	md5 编码

返回

• JSON 编码后的字符串

fromJson() JSON 转化为数组

public static function fromJson( string $json [, bool $assoc = true ] ) : array

参数

• json JSON 字符串

• assoc 是否返回 array

  当该参数为 true 时，将返回 array 否则为 object

返回

• array / object

getError() 获取错误

public static function getError() : array

参数

• 无

返回

• 获取数组处理时产生的错误消息