HOWTO · Ruby
如何在 Ruby Hash 中新增或更新項目
說明如何在 Ruby 的 Hash 中新增或更新項目,並介紹方括號指派、merge、merge! 與 store 的用法。
本頁內容
若要在 Ruby 的 Hash 中新增一組鍵值,請使用方括號運算子指定值:hash[key] = value。鍵不存在時會新增;鍵已存在時則會取代其值。若要處理多組鍵值,merge 會回傳合併後的 Hash,而原本的物件保持不變;merge! 則會修改接收呼叫的物件。若只處理一組鍵值,也可以使用 store(key, value) 這種方法呼叫。這些操作都能新增或更新項目,請依鍵值組數,以及是否要修改原本的 Hash 來選擇。
使用 [] 新增或更新一個 Hash 項目
只處理一個項目時,方括號寫法最直接。將鍵放在指派運算式左側的 [] 中,再為它指定值。Ruby 會依據鍵的相等性與雜湊行為尋找既有項目。若找到符合的鍵,指派會取代該項目的值,不會建立第二個相同的鍵;否則就會新增一組鍵值。
執行以下範例:
本節中的程式碼以及顯示的標籤或輸出仍為英文。
country_codes = {
'Nigeria' => 'NG',
'United States' => 'US'
}
country_codes['Canada'] = 'CA'
puts country_codes
此處的 country_codes 一開始有兩組以字串為鍵的項目;指派會新增加拿大的 CA 代碼,讓 Hash 中共有三組鍵值。若要取代值,也可以使用方括號指派:為 'Canada' 指派另一個值,就會更新既有項目。這種語法通常稱為方括號指派;在運算式右側使用 [] 會讀取值,在左側使用 [] = 則會寫入值。
使用 merge 和 merge! 新增多個項目
當輸入資料包含多個項目,而且你希望得到新的 Hash 時,請使用 merge。它會將接收呼叫物件中的項目與引數 Hash 中的項目合併。若兩者有相同的鍵,回傳的 Hash 會採用引數中的值。原本的接收呼叫物件不會改變;當你需要保留起始資料時,這點很有用。
本節中的程式碼以及顯示的標籤或輸出仍為英文。
country_codes = { 'Canada' => 'CA', 'Nigeria' => 'NG' }
updated_codes = country_codes.merge({ 'Canada' => 'CAN', 'Ghana' => 'GH' })
puts updated_codes
puts country_codes
指派給 updated_codes 的值中,Canada 對應到 CAN,並且包含 Ghana。country_codes 中加拿大原本的 CA 值仍然保留,也沒有 Ghana 項目。這同時說明了重複鍵的優先順序,以及 merge 會回傳另一個結果。
若要將合併後的項目寫入現有的接收呼叫物件,請使用 merge!。它遵循相同的重複鍵規則:引數 Hash 中的值會取代接收呼叫物件中相同鍵的值。此方法會在修改接收呼叫物件後回傳它,因此不必另外指定結果變數。
country_codes = { 'Canada' => 'CA', 'Nigeria' => 'NG' }
country_codes.merge!({ 'Canada' => 'CAN', 'Ghana' => 'GH' })
puts country_codes
呼叫完成後,country_codes 會包含更新後的加拿大值,以及新增的 Ghana 項目。驚嘆號是此方法名稱的一部分,通常表示操作會修改接收呼叫的物件。若要保留原本的 Hash,請改用 merge。
使用 store 新增或更新項目
store(key, value) 是以方法呼叫方式寫入單一項目的替代寫法。鍵不存在時會新增這組鍵值;鍵已存在時則會更新其值,行為與 hash[key] = value 相同。如果明確傳入鍵和值的形式在程式碼中更易讀,可以選擇這種寫法;它不會採用不同的重複鍵處理規則。
本節中的程式碼以及顯示的標籤或輸出仍為英文。
items = { item1: 'Notebook' }
items.store(:item2, 'Pencil')
puts items
在此範例中,:item1 和 :item2 是 symbol,而 'Notebook' 和 'Pencil' 是字串。這次呼叫會新增 symbol 鍵 :item2 及其對應值。若呼叫 store(:item1, 'Journal'),該既有 symbol 鍵的值就會改變。加上引號的鍵,例如 'item1',是字串,與 symbol :item1 不同。
新增一組鍵值時,可選擇方括號指派或 store;兩者都會修改接收呼叫的物件。新增多組鍵值時,可選擇 merge 以保留起始的 Hash,或選擇 merge! 以更新它。在這兩種 merge 操作中,若兩個 Hash 包含相同的鍵,引數中的值會優先。