التابع 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[]
: ينشئ جدولHash
جديد ويضع فيه الكائنات المعطاة. - التابع
try_convert
: يحاول تحويل الكائن المُمرَّر إليه إلى النوعHash
باستخدام التابعto_hash
.