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 中与给定的键相关的值。 |