الفرق بين المراجعتين لصفحة: «Ruby/Hash/key»

المراجعة الحالية بتاريخ 15:34، 26 نوفمبر 2018

يعيد التابع key المفتاح المقابل لقيمة معيَّنة في الكائن Hash الذي استدعي معه.

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

key(value) → key

المعاملات

`value`

القيمة المراد جلب المفتاح المرتبط لها.

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

تعاد المفتاح المقابل للقيمة value في الكائن Hash المعطى، أو تعاد القيمة nil إذا كانت تلك القيمة غير موجودة.

أمثلة

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

h = { "a" => 100, "b" => 200, "c" => 300, "d" => 300 }
h.key(200)   #=> "b"
h.key(300)   #=> "c"
h.key(999)   #=> nil

انظر أيضا

التابع key?‎: يتحقق إذا كان مفتاحٌ محدَّدٌ موجودًا في الكائن Hash المستدعى معه.

التابع keys: يعيد مصفوفة جديدة تحوي مفاتيح الكائن Hash الذي استدعي معه.

مصادر

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

@@ سطر 3: / سطر 3: @@
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby Hash]]
-يعيد التابع <code>key</code> ت
+يعيد التابع <code>key</code> المفتاح المقابل لقيمة معيَّنة في الكائن <code>[[Ruby/Hash|Hash]]</code> الذي استدعي معه.
 ==البنية العامة==
 <syntaxhighlight lang="ruby">key(value) → key</syntaxhighlight>
 ==المعاملات==
+=== <code>value</code> ===
+القيمة المراد جلب المفتاح المرتبط لها.
 ==القيمة المعادة==
-تعاد
+تعاد المفتاح المقابل للقيمة <code>value</code> في الكائن <code>[[Ruby/Hash|Hash]]</code> المعطى، أو تعاد القيمة <code>nil</code> إذا كانت تلك القيمة غير موجودة.
+== أمثلة ==
+مثال على استعمال التابع <code>key</code>:<syntaxhighlight lang="ruby">
+h = { "a" => 100, "b" => 200, "c" => 300, "d" => 300 }
+h.key(200)   #=> "b"
+h.key(300)   #=> "c"
+h.key(999)   #=> nil
+</syntaxhighlight>
 ==انظر أيضا==
-*
+* التابع <code>[[Ruby/Hash/key-3F|key?‎]]</code>: يتحقق إذا كان مفتاحٌ محدَّدٌ موجودًا في الكائن <code>[[Ruby/Hash|Hash]]</code> المستدعى معه.
+* التابع <code>[[Ruby/Hash/keys|keys]]</code>: يعيد مصفوفة جديدة تحوي مفاتيح الكائن <code>[[Ruby/Hash|Hash]]</code> الذي استدعي معه.
 ==مصادر==
 *[http://ruby-doc.org/core-2.5.1/Hash.html#method-i-key قسم التابع key في الصنف Hash في توثيق روبي الرسمي.]