Hash(雜湊表)是 Ruby 中鍵值對集合,鍵可以是任意物件(不限整數),提供 O(1) 平均查找效能。本文詳細介紹 Hash 建立、預設值機制、核心方法與實戰模式。
Hash.new # 空 Hash,預設值 nil
Hash.new("month") # 空 Hash,預設值 "month"
Hash.new { |h,k| h[k] = [] } # 區塊預設值(每個缺失鍵調用區塊)
Hash["a" => 100, "b" => 200] # 字面值建立
{ "a" => 100, "b" => 200 } # 字面值(最常用)
{ a: 100, b: 200 } # Symbol 鍵簡寫(Ruby 1.9+)
months = Hash.new("month")
months[0] # => "month" (回傳預設值)
months[72] # => "month"
# 注意:所有缺失鍵共享同一個預設值物件(若為可變物件需謹慎)
# 區塊形式:每個缺失鍵產生獨立物件
h = Hash.new { |hash, key| hash[key] = [] }
h[:a] << 1 # => [1]
h[:b] << 2 # => [2] (獨立陣列)
h = { "a" => 100, "b" => 200 }
h["a"] # => 100
h.fetch("a") # => 100 (鍵不存在拋 KeyError)
h.fetch("z", "default") # => "default"
h.key?(100) # => false (檢查值)
h.value?(100) # => true
h.keys # => ["a", "b"]
h.values # => [100, 200]
h.to_a # => [["a",100], ["b",200]]
| 類別 | 方法 | 說明 |
|---|---|---|
| 新增/刪除 | h[key] = val | 設定/更新 |
store(key, val) | 同前,可鏈式 | |
delete(key) | 刪除鍵,返回值 | |
delete_if / reject! { |k,v| ... } | 條件刪除 | |
clear | 清空 | |
shift | 移除並返回第一組鍵值對 | |
| 合併/轉換 | merge / merge! | 合併 Hash(區塊處理衝突) |
invert | 鍵值互換(值重複會遺失) | |
to_a / to_h | 轉陣列/Hash | |
transform_keys / transform_values | 轉換鍵/值 (Ruby 2.5+) | |
slice(*keys) | 取子集 (Ruby 2.5+, Rails 擴充) | |
except(*keys) | 排除鍵 (Rails) | |
| 查找/疊代 | each / each_pair / each_key / each_value | 遍歷 |
select / reject / filter | 篩選返回新 Hash | |
find / detect | 找第一組符合 | |
any? / all? / none? | 條件量化 | |
dig(key1, key2, ...) | 安全巢狀查找 (Ruby 2.3+) | |
fetch_values(*keys) | 批量取值,缺失拋錯 |
HashWithIndifferentAccess (Rails) 允許兩者互通。# 群組計數
counts = Hash.new(0)
items.each { |item| counts[item] += 1 }
# 分組
groups = Hash.new { |h,k| h[k] = [] }
items.each { |item| groups[item.category] << item }
# 快取/記憶化
cache = {}
cache[key] ||= expensive_computation(key)
# 選項合併(預設值 + 使用者覆寫)
defaults = { timeout: 30, retries: 3 }
options = defaults.merge(user_options)
Hash.new(capacity) (Ruby 3.2+)。frozen 字串鍵減少分配。