Ruby/Hash/new

ينشئ التابع new جدول Hash جديد فارغ ثم يعيده. إذا أجريت بعد ذلك محاولة للوصول إلى مفتاح غير موجود وغير مرتبط بقيمة، فستعاد قيمة تعتمد على كيفية استدعاء التابع new لإنشاء الجدول Hash هذا.

البنية العامة

new → new_hash
new(obj) → new_hash
new {|hash, key| block } → new_hash

في الشكل الأول من التابع new، تعيد أية محاولة للوصول إلى مفتاحٍ القيمة nil. إذا أعطي المعامل obj في الشكل الثاني، فستُستخدم قيمته وحدها كقيمة افتراضية لكافة القيم. أمَّا إذا حُدِدت كتلة كما فيا الشكل الثالث، فستُستدعى مع الكائن Hash المُنشَأ آنذاك والمفتاح الذي أجريت محاول للوصول إليه، ويجب أن تعيد القيمة الافتراضية. ومن مسؤولية الكتلة أيضًا تخزين القيمة في الجدول Hash إذا لزم الأمر.

المعاملات

obj

الكائن المراد تعيينه كقيمة افتراضية.

القيمة المعادة

يعاد كائن جديد فارغ من النوع Hash.

أمثلة

مثال على استعمال التابع new:

h = Hash.new("Go Fish")
h["a"] = 100
h["b"] = 200
h["a"]           #=> 100
h["c"]           #=> "Go Fish"
# تعيد الاستدعاءات التالية القيمة الافتراضية المحددة
h["c"].upcase!   #=> "GO FISH"
h["d"]           #=> "GO FISH"
h.keys           #=> ["a", "b"]

# بينما تنشئ الاستدعاء التالية قيمة افتراضية في كل مرة
h = Hash.new { |hash, key| hash[key] = "Go Fish: #{key}" }
h["c"]           #=> "Go Fish: c"
h["c"].upcase!   #=> "GO FISH: C"
h["d"]           #=> "Go Fish: d"
h.keys           #=> ["c", "d"]

انظر أيضا

• المعامل []: ينشئ جدول Hash جديد ويضع فيه الكائنات المعطاة.
• التابع try_convert: يحاول تحويل الكائن المُمرَّر إليه إلى النوع Hash باستخدام التابع to_hash.

مصادر

• قسم التابع new في الصنف Hash في توثيق روبي الرسمي.