# Ruby 哈希(Hash)
哈希(Hash)是类似 "employee" => "salary" 这样的键值对的集合。哈希的索引是通过任何对象类型的任意键来完成的,而不是一个整数索引,其他与数组相似。
通过键或值遍历哈希的顺序看起来是随意的,且通常不是按照插入顺序。如果您尝试通过一个不存在的键访问哈希,则方法会返回 _nil_。
## 创建哈希
与数组一样,有各种不同的方式来创建哈希。您可以通过 _new_ 类方法创建一个空的哈希:
```
months = Hash.new
```
您也可以使用 _new_ 创建带有默认值的哈希,不带默认值的哈希是 _nil_:
```
months = Hash.new( "month" )
or
months = Hash.new "month"
```
当您访问带有默认值的哈希中的任意键时,如果键或值不存在,访问哈希将返回默认值:
```
#!/usr/bin/ruby
months = Hash.new( "month" )
puts "#{months[0]}"
puts "#{months[72]}"
```
这将产生以下结果:
```
month
month
```
```
#!/usr/bin/ruby
H = Hash["a" => 100, "b" => 200]
puts "#{H['a']}"
puts "#{H['b']}"
```
这将产生以下结果:
```
100
200
```
您可以使用任何的 Ruby 对象作为键或值,甚至可以使用数组,所以下面的实例是一个有效的实例:
```
[1,"jan"] => "January"
```
## 哈希内建方法
我们需要有一个 Hash 对象的实例来调用 Hash 方法。下面是创建 Hash 对象实例的方式:
```
Hash[[key =>|, value]* ] or
Hash.new [or] Hash.new(obj) [or]
Hash.new { |hash, key| block }
```
这将返回一个使用给定对象进行填充的新的哈希。现在,使用创建的对象,我们可以调用任意可用的实例方法。例如:
```
#!/usr/bin/ruby
$, = ", "
months = Hash.new( "month" )
months = {"1" => "January", "2" => "February"}
keys = months.keys
puts "#{keys}"
```
这将产生以下结果:
```
2, 1
```
下面是公共的哈希方法(假设 _hash_ 是一个 Hash 对象):
| 方法 | 描述 |
| --- | --- |
| **hash == other_hash** | 检查两个哈希是否具有相同的键值对个数,键值对是否相互匹配,来判断两个哈希是否相等。 |
| **hash.[key]** | 使用键,从哈希引用值。如果未找到键,则返回默认值。 |
| **hash.[key]=value** | 把 _value_ 给定的值与 _key_ 给定的键进行关联。 |
| **hash.clear** | 从哈希中移除所有的键值对。 |
| **hash.default(key = nil)** | 返回 _hash_ 的默认值,如果未通过 default= 进行设置,则返回 nil。(如果键在 _hash_ 中不存在,则 [] 返回一个默认值。) |
| **hash.default = obj** | 为 _hash_ 设置默认值。 |
| **hash.default_proc** | 如果 _hash_ 通过块来创建,则返回块。 |
| **hash.delete(key) [or] array.delete(key) { |key| block }** | 通过 _key_ 从 _hash_ 中删除键值对。如果使用了块 且未找到匹配的键值对,则返回块的结果。把它与 _delete_if_ 进行比较。 |
| **hash.delete_if { |key,value| block }** | 为 block 为 _true_ 的每个块,从 _hash_ 中删除键值对。 |
| **hash.each { |key,value| block }** | 遍历 _hash_,为每个 _key_ 调用一次 block,传递 key-value 作为一个二元素数组。 |
| **hash.each_key { |key| block }** | 遍历 _hash_,为每个 _key_ 调用一次 block,传递 _key_ 作为参数。 |
| **hash.each_key { |key_value_array| block }** | 遍历 _hash_,为每个 _key_ 调用一次 block,传递 _key_ 和 _value_ 作为参数。 |
| **hash.each_key { |value| block }** | 遍历 _hash_,为每个 _key_ 调用一次 block,传递 _value_ 作为参数。 |
| **hash.empty?** | 检查 hash 是否为空(不包含键值对),返回 _true_ 或 _false_。 |
| **hash.fetch(key [, default] ) [or] hash.fetch(key) { | key | block }** | 通过给定的 _key_ 从 _hash_ 返回值。如果未找到 _key_,且未提供其他参数,则抛出 _IndexError_ 异常;如果给出了 _default_,则返回 _default_;如果指定了可选的 block,则返回 block 的结果。 |
| **hash.has_key?(key) [or] hash.include?(key) [or] hash.key?(key) [or] hash.member?(key)** | 检查给定的 _key_ 是否存在于哈希中,返回 _true_ 或 _false_。 |
| **hash.has_value?(value)** | 检查哈希是否包含给定的 _value_。 |
| **hash.index(value)** | 为给定的 _value_ 返回哈希中的 _key_,如果未找到匹配值则返回 _nil_。 |
| **hash.indexes(keys)** | 返回一个新的数组,由给定的键的值组成。找不到的键将插入默认值。该方法已被废弃,请使用 select。 |
| **hash.indices(keys)** | 返回一个新的数组,由给定的键的值组成。找不到的键将插入默认值。该方法已被废弃,请使用 select。 |
| **hash.inspect** | 返回哈希的打印字符串版本。 |
| **hash.invert** | 创建一个新的 _hash_,倒置 _hash_ 中的 _keys_ 和 _values_。也就是说,在新的哈希中,_hash_ 中的键将变成值,值将变成键。 |
| **hash.keys** | 创建一个新的数组,带有 _hash_ 中的键。/td> |
| **hash.length** | 以整数形式返回 _hash_ 的大小或长度。 |
| **hash.merge(other_hash) [or] hash.merge(other_hash) { |key, oldval, newval| block }** | 返回一个新的哈希,包含 _hash_ 和 _other_hash_ 的内容,重写 hash 中与 _other_hash_ 带有重复键的键值对。 |
| **hash.merge!(other_hash) [or] hash.merge!(other_hash) { |key, oldval, newval| block }** | 与 merge 相同,但实际上 hash 发生了变化。 |
| **hash.rehash** | 基于每个 _key_ 的当前值重新建立 _hash_。如果插入后值发生了改变,该方法会重新索引 _hash_。 |
| **hash.reject { |key, value| block }** | 为 _block_ 为 _true_ 的每个键值对创建一个新的 _hash_。 |
| **hash.reject! { |key, value| block }** | 与 _reject_ 相同,但实际上 hash 发生了变化。 |
| **hash.replace(other_hash)** | 把 _hash_ 的内容替换为 _other_hash_ 的内容。 |
| **hash.select { |key, value| block }** | 返回一个新的数组,由 _block_ 返回 _true_ 的 _hash_ 中的键值对组成。 |
| **hash.shift** | 从 _hash_ 中移除一个键值对,并把该键值对作为二元素数组返回。 |
| **hash.size** | 以整数形式返回 _hash_ 的 _size_ 或 length。 |
| **hash.sort** | 把 _hash_ 转换为一个包含键值对数组的二维数组,然后进行排序。 |
| **hash.store(key, value)** | 存储 _hash_ 中的一个键值对。 |
| **hash.to_a** | 从 hash 中创建一个二维数组。每个键值对转换为一个数组,所有这些数组都存储在一个数组中。 |
| **hash.to_hash** | 返回 _hash_(self)。 |
| **hash.to_s** | 把 _hash_ 转换为一个数组,然后把该数组转换为一个字符串。 |
| **hash.update(other_hash) [or] hash.update(other_hash) {|key, oldval, newval| block}** | 返回一个新的哈希,包含 _hash_ 和 _other_hash_ 的内容,重写 _hash_ 中与 _other_hash_ 带有重复键的键值对。 |
| **hash.value?(value)** | 检查 _hash_ 是否包含给定的 _value_。 |
| **hash.values** | 返回一个新的数组,包含 _hash_ 的所有值。 |
| **hash.values_at(obj, ...)** | 返回一个新的数组,包含 _hash_ 中与给定的键相关的值。 |
- Ruby 基础
- Ruby 简介
- Ruby 环境
- Ruby 安装 - Unix
- Ruby 安装 - Windows
- Ruby 命令行选项
- Ruby 环境变量
- Ruby 语法
- Ruby 数据类型
- Ruby 类和对象
- Ruby 类案例
- Ruby 变量
- Ruby 运算符
- Ruby 注释
- Ruby 判断
- Ruby 循环
- Ruby 方法
- Ruby 块
- Ruby 模块(Module)
- Ruby 字符串(String)
- Ruby 数组(Array)
- Ruby 哈希(Hash)
- Ruby 日期 & 时间(Date & Time)
- Ruby 范围(Range)
- Ruby 迭代器
- Ruby 文件的输入与输出
- Ruby File 类和方法
- Ruby Dir 类和方法
- Ruby 异常
- Ruby 高级
- Ruby 面向对象
- Ruby 正则表达式
- Ruby 数据库访问 - DBI 教程
- Ruby CGI 编程
- Ruby CGI方法
- Ruby CGI Cookies
- Ruby CGI Sessions
- Ruby 发送邮件 - SMATP
- Ruby Socket 编程
- Ruby XML, XSLT 和 XPath 教程
- Ruby Web Services 应用 - SOAP4R
- Ruby 多线程
- 免责声明