天天看點

Ruby 哈希(Hash)

哈希(Hash)是類似 "key" => "value" 這樣的鍵值對集合。哈希類似于一個數組,隻不過它的索引不局限于使用數字。

Hash 的索引(或者叫"鍵")幾乎可以是任何對象。

Hash 雖然和數組類似,但卻有一個很重要的差別:Hash 的元素沒有特定的順序。 如果順序很重要的話就要使用數組了。

與數組一樣,有各種不同的方式來建立哈希。您可以通過 new 類方法建立一個空的哈希:

months = Hash.new

您也可以使用 new 建立帶有預設值的哈希,不帶預設值的哈希是 nil:

months = Hash.new( "month" )

months = Hash.new "month"

當您通路帶有預設值的哈希中的任意鍵時,如果鍵或值不存在,通路哈希将傳回預設值:

#!/usr/bin/ruby

puts "#{months[0]}"

puts "#{months[72]}"

以上執行個體運作輸出結果為:

H = Hash["a" => 100, "b" => 200]

puts "#{H['a']}"

puts "#{H['b']}"

您可以使用任何的 Ruby 對象作為鍵或值,甚至可以使用數組,如下執行個體所示:

[1,"jan"] => "January"

如果需要調用 Hash 方法,需要先執行個體化一個 Hash 對象。下面是建立 Hash 對象執行個體的方式:

Hash[[key =>|, value]* ] or

Hash.new [or] Hash.new(obj) [or]

Hash.new { |hash, key| block }

這将傳回一個使用給定對象進行填充的新的哈希。現在,使用建立的對象,我們可以調用任意可用的方法。例如:

$, = ", "

months = {"1" => "January", "2" => "February"}

keys = months.keys

puts "#{keys}"

下面是公共的哈希方法(假設 hash 是一個 Hash 對象):

序号

方法 & 描述

1

<b>hash == other_hash</b>

檢查兩個哈希是否具有相同的鍵值對個數,鍵值對是否互相比對,來判斷兩個哈希是否相等。

2

<b>hash[key]</b>

使用鍵,從哈希引用值。如果未找到鍵,則傳回預設值。

3

<b>hash[key]=value</b>

把 value 給定的值與 key 給定的鍵進行關聯。

4

<b>hash.clear</b>

從哈希中移除所有的鍵值對。

5

<b>hash.default(key = nil)</b>

傳回 hash 的預設值,如果未通過 default= 進行設定,則傳回 nil。(如果鍵在 hash 中不存在,則 [] 傳回一個預設值。)

6

<b>hash.default = obj</b>

為 hash 設定預設值。

7

<b>hash.default_proc</b>

如果 hash 通過塊來建立,則傳回塊。

8

<b>hash.delete(key) [or]</b>

array.delete(key) { |key| block }

通過 key 從 hash 中删除鍵值對。如果使用了塊 且未找到比對的鍵值對,則傳回塊的結果。把它與 delete_if 進行比較。

9

<b>hash.delete_if { |key,value| block }</b>

block 為 true 的每個塊,從 hash 中删除鍵值對。

10

<b>hash.each { |key,value| block }</b>

周遊 hash,為每個 key 調用一次 block,傳遞 key-value 作為一個二進制素數組。

11

<b>hash.each_key { |key| block }</b>

周遊 hash,為每個 key 調用一次 block,傳遞 key 作為參數。

12

<b>hash.each_key { |key_value_array| block }</b>

周遊 hash,為每個 key 調用一次 block,傳遞 key 和 value 作為參數。

13

<b>hash.each_value { |value| block }</b>

周遊 hash,為每個 key 調用一次 block,傳遞 value 作為參數。

14

<b>hash.empty?</b>

檢查 hash 是否為空(不包含鍵值對),傳回 true 或 false。

15

<b>hash.fetch(key [, default] ) [or]</b>

hash.fetch(key) { | key | block }

通過給定的 key 從 hash 傳回值。如果未找到 key,且未提供其他參數,則抛出 IndexError 異常;如果給出了 default,則傳回 default;如果指定了可選的 block,則傳回 block 的結果。

16

<b>hash.has_key?(key) [or] hash.include?(key) [or]</b>

hash.key?(key) [or] hash.member?(key)

檢查給定的 key 是否存在于哈希中,傳回 true 或 false。

17

<b>hash.has_value?(value)</b>

檢查哈希是否包含給定的 value。

18

<b>hash.index(value)</b>

為給定的 value 傳回哈希中的 key,如果未找到比對值則傳回 nil。

19

<b>hash.indexes(keys)</b>

傳回一個新的數組,由給定的鍵的值組成。找不到的鍵将插入預設值。該方法已被廢棄,請使用 select。

20

<b>hash.indices(keys)</b>

21

<b>hash.inspect</b>

傳回哈希的列印字元串版本。

22

<b>hash.invert</b>

建立一個新的 hash,倒置 hash 中的 keys 和 values。也就是說,在新的哈希中,hash 中的鍵将變成值,值将變成鍵。

23

<b>hash.keys</b>

建立一個新的數組,帶有 hash 中的鍵。

24

<b>hash.length</b>

以整數形式傳回 hash 的大小或長度。

25

<b>hash.merge(other_hash) [or]</b>

hash.merge(other_hash) { |key, oldval, newval| block }

傳回一個新的哈希,包含 hash 和 other_hash 的内容,重寫 hash 中與 other_hash 帶有重複鍵的鍵值對。

26

<b>hash.merge!(other_hash) [or]</b>

hash.merge!(other_hash) { |key, oldval, newval| block }

與 merge 相同,但實際上 hash 發生了變化。

27

<b>hash.rehash</b>

基于每個 key 的目前值重建立立 hash。如果插入後值發生了改變,該方法會重新索引 hash。

28

<b>hash.reject { |key, value| block }</b>

類似 delete_if, 但作用在一個拷貝的哈希上。相等于 hsh.dup.delete_if。

29

<b>hash.reject! { |key, value| block }</b>

相等于 delete_if, 但是如果沒有修改,傳回 nil。

30

<b>hash.replace(other_hash)</b>

把 hash 的内容替換為 other_hash 的内容。

31

<b>hash.select { |key, value| block }</b>

傳回一個新的數組,由 block 傳回 true 的 hash 中的鍵值對組成。

32

<b>hash.shift</b>

從 hash 中移除一個鍵值對,并把該鍵值對作為二進制素數組傳回。

33

<b>hash.size</b>

以整數形式傳回 hash 的 size 或 length。

34

<b>hash.sort</b>

把 hash 轉換為一個包含鍵值對數組的二維數組,然後進行排序。

35

<b>hash.store(key, value)</b>

存儲 hash 中的一個鍵值對。

36

<b>hash.to_a</b>

從 hash 中建立一個二維數組。每個鍵值對轉換為一個數組,所有這些數組都存儲在一個數組中。

37

<b>hash.to_hash</b>

傳回 hash(self)。

38

<b>hash.to_s</b>

把 hash 轉換為一個數組,然後把該數組轉換為一個字元串。

39

<b>hash.update(other_hash) [or]</b>

hash.update(other_hash) {|key, oldval, newval| block}

40

<b>hash.value?(value)</b>

檢查 hash 是否包含給定的 value。

41

<b>hash.values</b>

傳回一個新的數組,包含 hash 的所有值。

42

<b>hash.values_at(obj, ...)</b>

傳回一個新的數組,包含 hash 中與給定的鍵相關的值。