نتائج البحث

ينشئ التابع Hash[]‎ جدول Hash جديد ويضع فيه الكائنات المعطاة. بشكل مشابه للصيغة ‎{ key => value, ... }‎، تأتي المفاتيح والقيم -في الشكل الأول- في أزواج، لذلك يجب أن يكون هناك عدد زوجي من الوسائط دومًا. يُمرَّر في الشكلين الثاني والثالث (انظر البنية العامة) وسيطٌا واحدٌا ويكون إمَّا مصفوفة من الأزواج قيمة/مفتاح أو كائن قابل للتحويل إلى النوع Hash. البنية العامة Hash[ key, value, ... ] → new_hash Hash[ [ [key, value], ... ] ] → new_hash Hash[ object ] → new_hash ...

النوع Hash (أو الجدول Hash كما يطلق عليه أحيانًا) هو مجموعة تشبه القاموس ويتكون من مفاتيح فريدة وقيم مرتبطة بها. كما يسمى أيضًا المصفوفات الترابطية، فهو يشبه المصفوفات، ولكن بينما تستخدم المصفوفة فقط الأعداد الصحيحة كفهرس، يسمح النوع Hash باستخدام أيٍّ من أنواع الكائنات لاستعمالها كفهرس وربطها بقيمٍ. ترتَّب وتحصى القيم في النوع Hash بنفس الترتيب الذي أُدرِجت فيه مفاتيحها المقابلة. يمكن إنشاء جدول Hash بسهولة باستخدام شكله الصريح: grades = { "Jane Doe" => 10, "Jim Doe" => 6 ...

تعيد الدّالة hash()‎ قيمة تجزئة (hash) الكائن المُعطى (إن امتلك الكائن تجزئةً معروفة). البنية العامة hash(object) المعاملات object الكائن المُراد الحصول على تجزئته. القيمة المعادة عدد صحيح يُمثّل قيمة تجزئة الكائن. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> hash(1) 1 >>> hash(1.0) 1 >>> hash('x') # تجزئة محرف واحد مباشرةً 5693259701801553312 >>> a = 'x' >>> hash(a) # تجزئة المحرف نفسه بعد تخزينه في مُتغيّر 5693259701801553312 ملاحظات تُستخدم التّجزئات لمُقارنة مفاتيح القواميس بسرعة أثناء بحث في القاموس. تملك القيم العدديّة التي تُساوي بعضها البعض نفس قيمة ...

مقدمة تقدم واجهة التجزئة الخاصة بإطار Laravel تجزئة Bcrypt و Argon2 آمنة لتخزين كلمات مرور المستخدم. إذا كنت تستخدم الصنفين الداخليين ‎(Built-in classes)‎ LoginController و RegisterController المتضمنين مع تطبيق Laravel الخاص بك، فإنهما يستخدمان Bcrypt للتسجيل والاستيثاق تلقائيًا. ملاحظة: يعدّ Bcrypt خيارًا رائعًا لتجزئة كلمات المرور لأن "عامل العمل" الخاص به قابل للتعديل، مما يعني أنه يمكن زيادة الوقت المستغرق لإنشاء تجزئة كلما زادت طاقة المعدات. الضبط يُضبط محرك تشغيل التجزئة التلقائي الخاص بتطبيقك في ملف الإعدادات config/hashing.php. يوجد حاليا ...

يربط المعامل [] عند استدعائه بالشكل hsh[key] = value القيمة value المعطاة بالمفتاح key في الجدول Hash. البنية العامة hsh[key] = value → value المعاملات key المفتاح الذي يراد ربط القيمة value المعطاة به. القيمة المعادة تعاد القيمة value نفسها بعد ربطها بالمفتاح key. أمثلة مثال على استعمال المعامل []: h = { "a" => 100, "b" => 200 } h["a"] = 9 h["c"] = 4 h #=> {"a"=>9, "b"=>200, "c"=>4} h.store("d", 42) #=> 42 h #=> {"a"=>9, "b"=>200, "c"=>4, "d"=>42} انتبه إلى ...

يجلب المعامل [] القيمة المقابلة لمفتاح معين في الجدول Hash المعطى. وإذا لم يُعثر عليه، فستُعاد القيمة الافتراضية (ارجع إلى التابع new لمزيد من التفاصيل حول القيمة الافتراضية). البنية العامة hsh[key] → value القيمة المعادة تعاد أمثلة مثال على استعمال المعامل []: h = { "a" => 100, "b" => 200 } h["a"] #=> 100 h["c"] #=> nil انظر أيضا المعامل []: يربط عند استدعائه بالشكل hsh[key] = value القيمة value المعطاة بالمفتاح key في الجدول Hash. التابع Hash[]‎: ينشئ ...

يعيد المعامل => القيمة true إذا كان الكائن Hash الواقع على يساره مجموعةً فرعيةً من الكائن الواقع على يمينه أو يساويه تمامًا. البنية العامة hash <= other → true or false القيمة المعادة تعاد القيمة true إذا كان الكائن hash مجموعة فرعية من الكائن other أو يساويه تمامًا. أمثلة مثال على استعمال المعامل =>: h1 = {a:1, b:2} h2 = {a:1, b:2, c:3} h1 <= h2 #=> true h2 <= h1 #=> false h1 <= h1 #=> true انظر ...

يعيد المعامل > القيمة true إذا كان الكائن Hash الواقع على يساره مجموعةً فرعيةً من الكائن الواقع على يمينه. البنية العامة hash < other → true or false القيمة المعادة تعاد القيمة true إذا كان الكائن hash الواقع على يساره مجموعةً فرعيةً من الكائن other الواقع على يمينه. أمثلة مثال على استعمال المعامل >: h1 = {a:1, b:2} h2 = {a:1, b:2, c:3} h1 < h2 #=> true h2 < h1 #=> false h1 < h1 ...

يعيد المعامل =< القيمة true إذا كان الكائن الواقع على يمينه مجموعةً فرعيةً من الكائن الواقع على يساره أو يساويه تمامًا. البنية العامة hash >= other → true or false القيمة المعادة تعاد القيمة true إذا كان الكائن other مجموعةً فرعيةً من الكائن hash أو يساويه تمامًا. h1 = {a:1, b:2} h2 = {a:1, b:2, c:3} h1 >= h2 #=> false h2 >= h1 #=> true h1 >= h1 #=> true انظر أيضا المعامل >: يعيد القيمة true إذا كان ...

يعيد المعامل < القيمة true إذا كان الكائن الواقع على يمينه مجموعةً فرعيةً من الكائن الواقع على يساره. البنية العامة hash > other → true or false القيمة المعادة تعاد القيمة true إذا كان other مجموعةً فرعيةً من hash. أمثلة مثال على استعمال المعامل <: h1 = {a:1, b:2} h2 = {a:1, b:2, c:3} h1 > h2 #=> false h2 > h1 #=> true h1 > h1 #=> false انظر أيضا المعامل >: يعيد القيمة true إذا ...

يتحقق المعامل == من تساوي كائنين من النوع Hash؛ أي يتحقق إذا كان كل منهما يحتوي على نفس العدد من المفاتيح وإذا كان كل زوج قيمة/مفتاح من أحد الكائنين يساوي الزوج المقابل له في الكائن الآخر (وفقًا للمعامل ==)‎. البنية العامة hsh == other_hash → true or false القيمة المعادة تعاد القيمة true إن كان الكائن hsh والكائن other_hash متساويين بغض النظر عن ترتيب الأزواج في كل منهما. أمثلة مثال على استعمال المعامل : h1 = { "a" => 1, "c" => ...

يحسب التابع hash الشيفرة hash للكائن Hash المستدعى معها. الكائنان Hash اللذان لهما نفس المحتوى يكون لهما نفس الشيفرة hash (وسيقارن بينهما باستخدام eql?‎). البنية العامة hash → integer القيمة المعادة يعاد عدد صحيح يمثِّل الشيفرة hash للكائن Hash المعطى. انظر أيضا التابع Object.hash: يحسب الشيفرة hash للكائن الذي استدعي معه. مصادر قسم التابع hash في الصنف Hash في توثيق روبي الرسمي.

يعيد التابع to_h الكائن Hash المعطى نفسه. إذا استُدعي على صنف فرعي من Hash، فستحوِّل المستقبل إلى كائن من النوع Hash. البنية العامة to_h → hsh or new_hash القيمة المعادة يعاد الكائن Hash المعطى نفسه. إذا كان المستقبل صنفًا فرعيًّا من Hash، فسيحوِّل إلى كائن من النوع Hash ويعاد. انظر أيضًا التابع to_a: يحول الكائن Hash الذي استدعي معه إلى مصفوفة متشعبة من المصفوفات [ key, value ]. التابع to_hash: يعيد الكائن Hash المعطى نفسه. التابع to_s: يعيد محتوى الكائن Hash ...

يعيد التابع hash القيمة Hash للمصفوفة التي استُدعيت معه. إن كان لمصفوفتين نفس المحتوى، فسيكون لهما نفس قيمة Hash (وسيوازن بينهما باستخدام eql?‎). البنية العامة hash → integer القيم المعادة يعاد عدد صحيح يمثل القيمة Hash للمصفوفة المعطاة. أمثلة مثالٌ على استخدام التابع hash: a = [ "a", "b", "c" ] a.hash # 2564204468492460516 انظر أيضًا التابع Object.hash: يعيد شيفرة Hash للكائن الذي استدعي معه. مصادر قسم التابع hash في الصنف Array في توثيق روبي الرسمي.

يعيد التابع to_hash الكائن Hash المعطى نفسه. البنية العامة to_hash => hsh القيمة المعادة يعاد الكائن Hash المعطى نفسه.  انظر أيضًا التابع to_a: يحول الكائن Hash الذي استدعي معه إلى مصفوفة متشعبة من المصفوفات [ key, value ]. التابع to_h: يعيد الكائن Hash المعطى نفسه. إذا استُدعي على صنف فرعي من Hash، فستحوِّل المستقبل إلى كائن من النوع Hash. التابع to_s: يعيد محتوى الكائن Hash الذي استدعي معه في سلسلة نصية. مصادر قسم التابع to_hash في الصنف Hash في توثيق روبي ...

يضيف التابع update محتويات الجدول Hash المعطى إلى متغيرات البيئة الحالية. البنية العامة update(hash) → Hash update(hash) { |name, old_value, new_value| } → Hash إن لم تُعطَ أية كتلة برمجية، فستُستبدَل قيم الأزواج ذات المفاتيح (keys) المكرَّرة أو يتم تحديد قيمة كل اسم مكرَّر عن طريق استدعاء الكتلة مع تمرير المفتاح (name) وقيمته من البيئة (old_value) وقيمته الجديدة (new_value) من الجدول Hash إليها لتحديد القيمة المراد إعتمادها. المعاملات hash جدول من النوع Hash يحوي الأزواج المراد إضافتها إلى البيئة. القيمة المعادة يُعاد الكائن ...

يحاول التابع try_convert تحويل الكائن المُمرَّر إليه إلى النوع Hash باستخدام التابع to_hash. يعيد التابع كائن من النوع Hash إن نجحت عملية التحويل أو القيمة nil إذا فشلت العملية لأي سبب. ash.try_convert({1=>2}) # => {1=>2} Hash.try_convert("1=>2") # => nil البنية العامة try_convert(obj) → hash or nil المعاملات obj الكائن المراد تحويله إلى النوع Hash. القيمة المعادة يعاد كائن من النوع Hash يمثِّل ناتج تحويل الكائن obj إن نجحت عملية التحويل، أو تعاد القيمة nil إذا فشلت العملية لأي ...

يعيد التابع hash القيمة hash للعدد العشري الذي استدعي معه. البنية العامة hash → integer القيمة المعادة يعاد عدد صحيح يمثِّل القيمة hash للعدد العشري المعطى. انظر أيضا التابع hash: يعيد القيمة hash للكائن الذي استدعي معه. التابع to_int: يحول العدد العشري الذي استدعي معه إلى عدد صحيح. مصادر قسم التابع hash في الصنف Float في توثيق روبي الرسمي.

يُبدِّل التابع replace محتويات الكائن المُمرَّر إليه مكان محتويات الكائن Hash الذي استدعي معه. البنية العامة replace(other_hash) → hsh المعاملات other_hash كائن من النوع Hash يراد تبديل محتوياته مكان محتويات الكائن Hash المعطى. القيمة المعادة يعاد الكائن Hash المعطى بعد تبديل محتوياته مكان محتويات الكائن other_hash. أمثلة مثال على استعمال التابع replace: h = { "a" => 100, "b" => 200 } h.replace({ "c" => 300, "d" => 400 }) #=> {"c"=>300, "d"=>400} انظر أيضًا التابع merge: يدمج كائنين من ...

ينشئ التابع new جدول Hash جديد فارغ ثم يعيده. إذا أجريت بعد ذلك محاولة للوصول إلى مفتاح غير موجود وغير مرتبط بقيمة، فستعاد قيمة تعتمد على كيفية استدعاء التابع new لإنشاء الجدول Hash هذا. البنية العامة new → new_hash new(obj) → new_hash new {|hash, key| block } → new_hash في الشكل الأول من التابع new، تعيد أية محاولة للوصول إلى مفتاحٍ القيمة nil. إذا أعطي المعامل obj في الشكل الثاني، فستُستخدم قيمته وحدها كقيمة افتراضية لكافة القيم. أمَّا إذا حُدِدت كتلة كما فيا الشكل ...

البنية العامة to_proc() انظر أيضا التابع to_a: يحول الكائن Hash الذي استدعي معه إلى مصفوفة متشعبة من المصفوفات [ key, value ]. التابع to_h: يعيد الكائن Hash المعطى نفسه. إذا استُدعي على صنف فرعي من Hash، فستحوِّل المستقبل إلى كائن من النوع Hash. التابع to_s: يعيد محتوى الكائن Hash الذي استدعي معه في سلسلة نصية. مصادر قسم التابع to_proc في الصنف Hash في توثيق روبي الرسمي.

يعيد التابع hash القيمة hash اعتمادًا على السلسلة النصية المستهدفة والتعبير النمطي (regexp) ومواضع المطابقة للكائن matchdata. البنية العامة hash→ integer‎ القيمة المعادة يعاد عدد صحيح يمثِّل القيمة hash. انظر أيضا التابع inspect: يعيد نسخة قابلة للطباعة من mtch. التابع hash: يعيد القيمة hash للكائن الذي استدعي معه. مصادر قسم التابع hash‎ في الصنف MatchData‎ في توثيق روبي الرسمي.

يحول التابع to_a الكائن Hash الذي استدعي معه إلى مصفوفة متشعبة من المصفوفات [ key, value ]. البنية العامة to_a → array القيمة المعادة تعاد مصفوفة متشعبة من المصفوفات [ key, value ] تمثِّل ناتج تحويل الكائن Hash المعطى. أمثلة مثال على استعمال التابع to_a: h = { "c" => 300, "a" => 100, "d" => 400, "c" => 300 } h.to_a #=> [["c", 300], ["a", 100], ["d", 400]] انظر أيضًا التابع to_h: يعيد الكائن Hash المعطى نفسه. إذا ...

يعدُّ التابع to_s اسمًا بديلًا للتابع inspect. البنية العامة to_s() القيمة المعادة تعاد سلسلة نصية تمثِّل محتويات الكائن Hash المعطى. انظر أيضا التابع to_a: يحول الكائن Hash الذي استدعي معه إلى مصفوفة متشعبة من المصفوفات [ key, value ]. التابع to_h: يعيد الكائن Hash المعطى نفسه. إذا استُدعي على صنف فرعي من Hash، فستحوِّل المستقبل إلى كائن من النوع Hash. مصادر قسم التابع to_s في الصنف Hash في توثيق روبي الرسمي.

يعيد التابع slice كائنًا من النوع Hash يحتوي فقط على مفاتيح محدَّدة وقيمها. البنية العامة slice(*keys) → a_hash المعاملات Keys المفاتيح التي يراد اقتطاعها من الكائن Hash المعطى ووضعها هي وقيمها في كائن منفصل. القيمة المعادة يعاد كائن من النوع Hash يحوي المفاتيح keys وقيمها الموجودة في الكائن Hash المعطى. أمثلة مثال على استعمال التابع slice: h = { a: 100, b: 200, c: 300 } h.slice(:a) #=> {:a=>100} h.slice(:b, :c, :d) ...

يضبط التابع default_proc إن استدعي بالشكل default_proc = proc_obj القيمة الافتراضية للكتلة التي ستُنفَّذ عند فشل أية عملية بحث عن مفتاح للكائن Hash المعطى. البنية العامة default_proc = proc_obj or nil الأمثلة مثال على استعمال التابع default_proc: h.default_proc = proc do |hash, key| hash[key] = key + key end h[2] #=> 4 h["cat"] #=> "catcat" انظر أيضا التابع new: ينشئ التابع new جدول Hash جديد فارغ ثم يعيده. التابع default: يضبط عند استدعائه بالشكل default = obj القيمة الافتراضية obj ...

يعيد التابع inspect محتوى الكائن Hash الذي استدعي معه في سلسلة نصية. يملك هذا التابع اسمًا بديلًا هو: to_s. البنية العامة to_s → string inspect → string القيمة المعادة تعاد سلسلة نصية تحوي جميع محتويات الكائن Hash المعطى. أمثلة مثال على استعمال التابع inspect: h = { "c" => 300, "a" => 100, "d" => 400, "c" => 300 } h.to_s #=> "{\"c\"=>300, \"a\"=>100, \"d\"=>400}" انظر أيضا التابع hash: يحسب الشيفرة hash للكائن Hash المستدعى معها. مصادر قسم التابع inspect ...

يضبط التابع default عند استدعائه بالشكل default = obj القيمة الافتراضية obj وهي القيمة التي ستُعاد لمفتاح غير موجود في الكائن Hash. لا يستطيع هذا التابع ضبط القيمة الافتراضية للعملية Proc التي ستُنفَّذ عند كل بحث عن مفتاح غير موجود. البنية العامة default = obj → obj القيمة المعادة تعاد القيمة الافتراضية obj التي ستُعاد لمفتاح غير موجود في الكائن Hash المعطى بعد تعيينها. أمثلة مثال على استعمال التابع default: h = { "a" => 100, "b" => 200 } h.default = ...

يدمج التابع merge كائنين من النوع Hash مع بعضهما بعضًا في كائن جديد من النوع Hash ثم يعيده. إذا لم تُحدد أية كتلة، فستكون قيمة الأزواج ذات المفاتيح المُكررة هي نفسها وتؤخذ من الكائن المُمرَّر إلى التابع. أما إن أعطيت، فستُحدَد قيمة كل مفتاح مكرَّر عن طريق استدعاء الكتلة مع المفتاح وقيمته من الكائن المعطى وقيمته من الكائن المُمرَّر. البنية العامة merge(other_hash) → new_hash merge(other_hash){|key, oldval, newval| block} → new_hash المعاملات other_hash كائن جديد من النوع Hash يراد دمج محتوياته مع الكائن ...

يعيد التابع transform_keys كائن جديد من النوع Hash مع ناتج تنفيذ الكتلة المعطاة مرةً واحدةً لكل مفتاح من مفاتيح الكائن Hash الذي استدعي معه. لا يُغيّر هذا التابع القيم المرتبطة بالمفاتيح. إذا لم تُعطَ أية كتلة، فسيُعاد كائن من النوع enumerator بدلًا من ذلك. البنية العامة transform_keys {|key| block } → new_hash transform_keys → an_enumerator القيمة المعادة يعاد كائن جديد من النوع Hash مع ناتج تنفيذ الكتلة المعطاة مرةً واحدةً لكل مفتاح من مفاتيح الكائن Hash المعطى، أو يعاد كائن من النوع ...

يعيد التابع transform_values كائن جديد من النوع Hash مع ناتج تنفيذ الكتلة المعطاة مرةً واحدةً لكل قيمة من قيم الكائن Hash الذي استدعي معه. لا يُغيّر هذا التابع المفاتيح. إذا لم تُعطَ أية كتلة، فسيُعاد كائن من النوع enumerator بدلًا من ذلك. البنية العامة transform_values {|value| block } → new_hash transform_values → an_enumerator القيمة المعادة يعاد كائن جديد من النوع Hash مع ناتج تنفيذ الكتلة المعطاة مرةً واحدةً لكل قيم من قيم الكائن Hash المعطى، أو يعاد كائن من النوع enumerator إن ...

يعيد التابع keys مصفوفة جديدة تحوي مفاتيح الكائن Hash الذي استدعي معه. البنية العامة keys → array القيمة المعادة تعاد مصفوفة جديدة تحوي مفاتيح الكائن Hash المعطى. أمثلة مثال على استعمال التابع keys: h = { "a" => 100, "b" => 200, "c" => 300, "d" => 400 } h.keys #=> ["a", "b", "c", "d"] انظر أيضا التابع has_key?‎: يتحقق إذا كان مفتاحٌ معيَّن موجودًا في الكائن Hash المعطى. التابع key: يعيد المفتاح المقابل لقيمة معيَّنة في الكائن Hash الذي ...

يتحقق التابع value?‎ إذا كانت القيمة المُمرَّرة إليه موجودةً ومرتبطةً بمفتاح ما في الكائن Hash المعطى. البنية العامة value?(value) → true or false المعاملات value القيمة المراد التحقق من وجودها وارتباطها بمفتاح في الكائن Hash المعطى. القيمة المعادة تعاد القيمة true إذا كانت القيمة المُمرَّرة إليه موجودةً ومرتبطةً بمفتاح ما في الكائن Hash المعطى. أمثلة مثال على استعمال التابع value?‎: h = { "a" => 100, "b" => 200 } h.value?(100) #=> true h.value?(999) #=> false انظر أيضا التابع ...

يعيد التابع hash القيمة hash استنادًا إلى محتويات هذه البنية. البنية العامة hash→ integer‎ القيمة المعادة يعاد عدد صحيح يمثِّل الشيفرة hash استنادًا إلى محتويات البنية المعطاة. انظر أيضًا التابع inspect: يعيد سلسلة نصية تحتوي وصفًا لهذه البنية. التابع Object.hash: يحسب القيمة hash للكائن الذي استدعي معه. مصادر قسم التابع hash‎ في الصنف Struct‎ في توثيق روبي الرسمي.

يعيد التابع hash القيمة hash المقابلة للتابع الحر الذي استُدعي معه. البنية العامة hash→ integer‎ القيمة المعادة يعاد عدد صحيح يمثِّل الشيفرة hash المقابلة للتابع الحر المعطى. انظر أيضًا التابع inspect: يعيد اسم التابع الأصلي (underlying method). التابع Object.hash: يحسب القيمة hash للكائن الذي استدعي معه. مصادر قسم التابع hash‎ في الصنف UnboundMethod‎ في توثيق روبي الرسمي.

يُعيد التابع hash القيمة hash للتوقيت الذي استدعي معه. البنية العامة hash→ integer‎ القيمة المعادة يعاد عدد صحيح يمثِّل القيمة hash للتوقيت المعطى. انظر أيضًا التابع gmt_offset: يعيد الفارق بين المنطقة الزمنية للتوقيت المعطى والتوقيت العالمي الموحد UTC بالثانية. التابع Object.hash: يحسب القيمة hash للكائن الذي استدعي معه. مصادر قسم التابع hash‎ في الصنف Time‎ في توثيق روبي الرسمي.

يتحقق التابع eql?‎ إذا كان كائنان من نفس النوع (النوع Hash) ولهما نفس المحتوى. لا يؤخذ ترتيب الأزواج بالحسبان. البنية العامة eql?(other) → true or false المعاملات other الكائن الآخر الذي يراد التحقق من تساويع مع الكائن Hash المعطى. القيمة المعادة تعاد القيمة true إذا كان كلٌ من الكائن Hash المعطى والكائن other من نفس النوع ولهما نفس المحتوى. انظر أيضا التابع any?‎: يمرر كل زوج من مفتاح/قيمة من أزواج الكائن Hash المعطى إلى كتلة معينة ثم يعيد القيمة true إن أعادت الكتلة قيمة غير ...

يتحقق التابع key?‎ إذا كان مفتاحٌ محدَّدٌ موجودًا في الكائن Hash المستدعى معه. انتبه إلى أنَّ التابع include?‎ والتابع member?‎ لا يختبرا تساوي الأعضاء باستخدام المعامل == كما تفعل غيرها من التوابع المحصية (enumerables). البنية العامة key?(key) → true or false المعاملات key المفتاح المراد التحقق من وجوده في الكائن الكائن Hash المعطى. القيمة المعادة تعاد القيمة true إذا كان المفتاح key موجودًا في الكائن Hash المعطى. أمثلة مثال على استعمال التابع key?‎: h = { "a" => 100, "b" => ...

يحسب التابع hash الشيفرة hash استنادًا إلى القيمة النصية وخيارات التعبير النمطي الذي استدعي معه. البنية العامة hash→ integer‎ القيمة المعادة يعاد عدد صحيح يمثِّل شيفرة hash المحسوبة للتعبير النمطي المعطى استنادًا إلى نص وخيارات هذا التعبير. انظر أيضًا التابع Object.hash: يحسب القيمة hash للكائن الذي استدعي معه. التابع inspect: يعيد نسخة نصية منسقة من التعبير النمطي المعطى. مصادر قسم التابع hash‎ في الصنف Regexp‎ في توثيق روبي الرسمي.

يعيد التابع rehash بناء الكائن Hash استنادًا إلى القيم الحالية لكل مفتاح. إذا تغيرت قيم كائنات المفاتيح منذ إدراجها، فسيعيد هذا التابع فهرسة الكائن Hash المعطى. إذا اُستدعيَ التابع rehash بينما يجتاز مُكرِّر الكائن Hash نفسه، فسيُطلَق الخطأ RuntimeError في المُكرِّر. البنية العامة rehash → hsh القيمة المعادة يعاد الكائن Hash المعطى نفسه بعد إجراء عملية إعادة البناء عليه. أمثلة مثال على استعمال التابع rehash: a = [ "a", "b" ] c = [ "c", "d" ] h = { a => 100, ...

يستدعي التابع transform_keys!‎ الكتلة المعطاة مرةً واحدةً لكل مفتاح من مفاتيح الكائن Hash المعطى، ويستبدل به المفتاح الجديد الذي تعيده الكتلة، ثم يعيد هذا الكائن. لا يُغيّر هذا التابع القيم. إذا لم تُعطَ أية كتلة، فسيُعاد كائن من النوع enumerator بدلًا من ذلك. البنية العامة transform_keys! {|key| block } → hsh transform_keys! → an_enumerator القيمة المعادة يعاد الكائن Hash المعطى نفسه بعد تبديل مفاتيحه إلى المفاتيح التي تعيدها الكتلة block عند تمرير المفتاح القديم إليها، أو يعاد كائن من النوع enumerator إن ...

يستدعي التابع transform_values!‎ الكتلة المعطاة مرةً واحدةً لكل قيمة من قيم الكائن Hash المعطى، ويستبدل به القيمة الجديد التي تعيدها الكتلة، ثم يعيد هذا الكائن. لا يُغيّر هذا التابع المفاتيح. إذا لم تُعطَ أية كتلة، فسيُعاد كائن من النوع enumerator بدلًا من ذلك. البنية العامة transform_values! {|value| block } → hsh transform_values! → an_enumerator القيمة المعادة يعاد الكائن Hash المعطى نفسه بعد تبديل قيمه إلى القيم التي تعيدها الكتلة block عند تمرير قيمة المفتاح القديم إليها، أو يعاد كائن من النوع enumerator ...

يعيد التابع values_at مصفوفةً تحتوي على القيم المرتبطة بمفاتيح محدَّدة من الكائن Hash الذي استدعي معه. البنية العامة values_at(key, ...) → array المعاملات key المفتاح المراد جلب القيمة المرتبطة به. ... المفاتيح الأخرى المراد جلب القيم المرتبطة بها. القيمة المعادة تعاد مصفوفةً تحتوي على القيم المرتبطة بالمفاتيح key و ... من الكائن Hash المعطى. أمثلة مثال على استعمال التابع values_at: h = { "cat" => "feline", "dog" => "canine", "cow" => "bovine" } h.values_at("cow", "cat") #=> ["bovine", "feline"] انظر أيضا التابع ...

يحسب التابع hash الشيفرة hash للمجال الذي استدعي معه. يكون لمجالين عنصرا بدايتهما ونهايتهما متساويان (وفق المعامل eql?‎)، وقيمة exclude_end?‎ الخاصة بهما متساوية أيضًا نفس رمز التكويد. البنية العامة hash → integer‎ ‎القيمة المعادة يعاد عدد صحيح يمثِّل الشيفرة hash للمجال المعطى. انظر أيضا التابع Object.hash: يحسب الشيفرة hash للكائن الذي استدعي معه. التابع first: يعيد الكائن الأول في المجال، أو يعيد مصفوفة مكونة من أول n عنصر. مصادر قسم التابع hash‎ في الصنف Range‎ في توثيق روبي الرسمي.

يضيف التابع merge!‎ محتويات الكائن Hash الذي مُمرِّر إليه إلى الكائن الذي استدعي معه. إذا لم تُحدَد أية كتلة، فسيُكتب فوق الأزواج ذات المفاتيح المكررة مع القيم من الكائن المُمرَّر. أما إن أعطيت، فستُحدَد قيمة كل مفتاح مكرَّر عن طريق استدعاء الكتلة مع المفتاح وقيمته من الكائن المعطى وقيمته من الكائن المُمرَّر. البنية العامة merge!(other_hash) → hsh merge!(other_hash){|key, oldval, newval| block} → hsh المعاملات other_hash كائن جديد من النوع Hash يراد دمج محتوياته مع الكائن Hash المعطى. القيمة المعادة يعاد الكائن Hash ...

يعيد التابع values مصفوفة جديدة تحوي قيم الكائن Hash الذي استدعي معه. البنية العامة values → array القيمة المعادة تعاد مصفوفة جديدة تحوي قيم الكائن Hash المعطى. أمثلة مثال على استعمال التابع values: h = { "a" => 100, "b" => 200, "c" => 300 } h.values #=> [100, 200, 300] انظر أيضا التابع keys: يعيد مصفوفة جديدة تحوي مفاتيح الكائن Hash الذي استدعي معه. التابع values_at: يعيد مصفوفةً تحتوي على القيم المرتبطة بمفاتيح محدَّدة من الكائن Hash الذي استدعي معه. مصادر ...

يحذف التابع select!‎ الأزواج التي تقبلها الكتلة المعطاة من الكائن Hash الذي استدعي معه.  يشبه هذا التابع التابع keep_if، ولكن يُعيد القيمة nil إذا لم تُجرَى أية تغييرات. البنية العامة select! {| key, value | block } → hsh or nil select! → an_enumerator القيمة المعادة يعاد الكائن Hash المعطى نفسه بعد حذف الأزواج التي تعيد الكتلة المعطاة القيمة true معها، أو تعاد القيمة nil إن لم تُجرَى أية تعديلات على الكائن. يعاد كائن كائن من النوع numerator إن لم تعطَ أية ...

يحذف التابع delete_if كل زوج قيمة-مفتاح يحقق شرطًا معيَّنًا من أزواج الكائن Hash المعطى. البنية العامة delete_if {| key, value | block } → hsh delete_if → an_enumerator القيم المعادة يعاد الكائن Hash المعطى بعد حذف الأزواج التي تُحقق الكتلة block بعد تمرير كل زوج من تلك الأزواج إليها (أي يعاد معها القيمة true عند تنفيذ الكتلة معها). إذا لم تُعطَ الكتلة block، فسيُعاد كائن من النوع enumerator بدلًا من ذلك. أمثلة مثال على استعمال التابع delete_if: h = { "a" ...

يعيد التابع default_proc الكتلة التي استُدعي التابع new معها عند إنشاء الكائن Hash المعطى، وإلا سيُعيد القيمة nil. البنية العامة default_proc → anObject المعاملات القيمة المعادة تعاد الكتلة التي استُدعي التابع new معها عند إنشاء الكائن Hash المعطى، وإلا فستُعاد القيمة nil. أمثلة مثال على استعمال التابع default_proc: h = Hash.new {|h,k| h[k] = k*k } #=> {} p = h.default_proc #=> #<Proc:0x401b3d08@-:1> a = ...

يضيف التابع update محتويات الكائن المُمرَّر إليه إلى الكائن Hash الذي استدعي معه. إذا لم تُحدَد أية كتلة، فسيُكتب فوق الأزواج ذات المفاتيح المكررة مع القيم من الكائن المُمرَّر، وإلا تُحدَّد قيمة كل مفتاح مكرَّر عن طريق استدعاء الكتلة مع المفتاح وقيمته في الكائن المستدعى وقيمته في الكائن المُمرَّر. البنية العامة update(other_hash) → hsh update(other_hash){|key, oldval, newval| block} → hsh المعاملات other_hash كائن من النوع Hash يراد إضافة محتواه إلى الكائن Hash المعطى. القيمة المعادة يعاد الكائن Hash المعطى نفسه بعد إضافة ...

يعيد التابع invert كائن جديد من النوع Hash يحوي قيم الكائن Hash الذي استدعي معه كمفاتيح ومفاتيحه كقيم فيه. البنية العامة invert → new_hash القيمة المعادة يعاد كائن جديد من النوع Hash تكون فيه قيم الكائن Hash المعطى كمفاتيح ومفاتيحه كقيم فيه. أمثلة إذا وُجِد بالفعل مفتاح بنفس القيمة في الكائن Hash المعطى، فسيستخدم التابع invert آخر واحد مُعرَّف، وستُتجاهل القيم التي تسبقه. انظر مثلًا إلى المثال التالي: h = { "n" => 100, "m" => 100, "y" => 300, "d" ...

يتحقق التابع empty?‎ إذا كان الكائن Hash الذي استدعي معه فارغًا أي لا يحتوي على أية أزواج. البنية العامة empty? → true or false القيمة المعادة تعاد القيمة true إذا الكائن Hash المعطى فارغًا أي لا يحتوي على أية أزواج. أمثلة مثال على استعمال التابع empty?‎: {}.empty? #=> true انظر أيضا التابع any?‎: يمرر كل زوج من مفتاح/قيمة من أزواج الكائن Hash المعطى إلى كتلة معينة ثم يعيد القيمة true إن أعادت الكتلة قيمة غير القيمة false أو nil. التابع eql?‎: يتحقق إذا كان كائنان من ...

يعيد التابع has_value?‎ إذا كانت قيمةٌ معيَّنةٌ موجودةً في الكائن Hash المعطى ومرتبطة بمفتاح. البنية العامة has_value?(value) → true or false المعاملات value القيمة المراد التحقق من وجودها. القيمة المعادة تعاد القيمة true إذا كانت القيمة value المُعطاة موجودةً ومرتبطة بمفتاح ما في الكائن Hash المعطى. أمثلة مثال على استعمال التابع has_value?‎: h = { "a" => 100, "b" => 200 } h.value?(100) #=> true h.value?(999) #=> false انظر أيضا التابع has_key?‎: يتحقق إذا كان مفتاحٌ معيَّن موجودًا في ...

يعيد التابع length عدد الأزواج قيمة-مفتاح الموجودة في الكائن Hash الذي استدعي معه. البنية العامة length → integer القيمة المعادة تعاد عدد صحيح يمثِّل عدد الأزواج قيمة-مفتاح الموجودة في الكائن Hash المعطى. أمثلة مثال على استعمال التابع length: h = { "d" => 100, "a" => 200, "v" => 300, "e" => 400 } h.length #=> 4 h.delete("a") #=> 200 h.length #=> 3 انظر أيضا التابع keys: يعيد ...

يعيد التابع default القيمة الافتراضية للمفتاح المُمرَّر إليه؛ أي يعيد القيمة التي سيعيدها الكائن Hash إذا كان المفتاح غير موجود فيه. البنية العامة default(key=nil) → obj المعاملات key المفتاح الذي يراد معرفة قيمته الافتراضية. القيمة المعادة تعاد القيمة الافتراضية للمفتاح key وهي القيمة التي سيعيدها الكائن Hash إذا كان المفتاح غير موجود فيه. أمثلة مثال على استعمال التابع default: h = Hash.new ...

يعيد التابع stat جدول Hash يحتوي على معلومات حول GC. ومن المتوقع أن يعمل هذا التابع فقط علي روبي C. البنية العامة stat → Hash stat(hash) → hash stat(:key) → Numeric القيمة المعادة يعاد جدول Hash يحوي معلومات حول GC. يتضمن الجدول معلومات حول الإحصائيات الداخلية حول GC مثل: { :count=>0, :heap_allocated_pages=>24, :heap_sorted_length=>24, :heap_allocatable_pages=>0, :heap_available_slots=>9783, :heap_live_slots=>7713, :heap_free_slots=>2070, :heap_final_slots=>0, ...

يعيد التابع select كائن جديد من النوع Hash يتكون من العناصر التي تعيد الكتلة المعطاة معها القيمة true. إذا لم تُعطَ أية كتلة، فسيُعاد كائن من النوع numerator بدلًا من ذلك. البنية العامة select {|key, value| block} → a_hash select → an_enumerator القيمة المعادة يعاد كائن جديد كائن جديد من النوع Hash يتكون من العناصر التي تعيد الكتلة المعطاة معها القيمة true، أو يعاد كائن كائن من النوع numerator إن لم تعطَ أية كتلة. أمثلة مثال على استعمال التابع select: h = ...

يحذف التابع delete زوجًا ذا مفتاح محدَّد ويعيد قيمته من الكائن Hash الذي استدعي معه. يُعيد التابع القيمة nil إذا كان المفتاح غير موجود. إذا أعطيت الكتلة الاختيارية وكان المفتاح غير موجود، فسيُمرَّر المفتاح إليها ويعاد ناتج تنفيذها. البنية العامة delete(key) → value delete(key) {| key | block } → value المعاملات key المفتاح المراد حذفه هو والقيمة المرتبطة به من الكائن Hash المعطى. القيمة المعادة تعاد القيمة المرتبطة بالمفتاح key بعد حذفهما من الكائن Hash المعطى، أو تعاد القيمة nil أو ...

يستدعي التابع each_key الكتلة المعطاة مرةً واحدةً لكل مفتاح من مفاتيح أزواج الكائن Hash الذي استدعي معه بعد تمرير مفتاح كل زوج إليها. البنية العامة each_key {| key | block } → hsh each_key → an_enumerator القيمة المعادة يعاد ناتج تنفيذ الكتلة block على كل زوج من أزواج الكائن Hash المعطى بعد تمرير مفتاح كل زوج إليها. إذا لم تُعطَ كتلة، يُعاد كائن من النوع enumerator بدلًا من ذلك.  أمثلة مثال على استعمال التابع each_key: h = { "a" => 100, ...

يتحقق التابع has_key?‎ إذا كان مفتاحٌ معيَّن موجودًا في الكائن Hash المعطى. انتبه إلى أنَّ التابع include?‎ والتابع member?‎ لا يختبرا تساوي الأعضاء باستخدام المعامل == كما تفعل غيرها من التوابع المحصية (enumerables). البنية العامة has_key?(key) → true or false المعاملات key المفتاح المراد التحقق من وجوده. القيمة المعادة تعاد القيمة true إذا كان المفتاح key موجودًا في الكائن Hash المعطى. أمثلة مثال على استعمال التابع has_key?‎: h = { "a" => 100, "b" => 200 } h.has_key?("a") #=> true h.has_key?("z") ...

يحذف التابع reject!‎ الأزواج التي ترفضها الكتلة المعطاة من الكائن Hash الذي استدعي معه. يشبه هذا التابع التابع delete_if، ولكن يُعيد القيمة nil إذا لم تُجرى أية تغييرات على الكائن المعطى. البنية العامة reject! {| key, value | block } → hsh or nil reject! → an_enumerator القيمة المعادة يعاد الكائن Hash المعطى نفسه بعد حذف الأزواج التي تعيد الكتلة block المعطاة معها القيمة false، أو تعاد القيمة nil إن لم تُجرَى أية تغييرات على الكائن. انظر أيضًا التابع reject: يعيد كائن ...

يعيد التابع stat كائنًا من النوع Hash يحوي عدادات مُخصصة (implementation-dependent counters) داخل الآلة الافتراضية (VM). يتضمن الكائن Hash معلومات حول تسلسلات ذاكرة التخزين المؤقت (cache serials) الخاصة بالتوابع والثوابت مثل: { :global_method_state=>251, :global_constant_state=>481, :class_serial=>9029 }‎ تقديم (implementation) محتويات الكائن Hash مخصوصة، ويمكن أن تتغير مع مرور الوقت. لا يُتوقّع أن يعمل هذا التابع إلا على على C Ruby. البنية العامة stat → Hash stat(hsh) → hsh stat(Symbol) → Numeric‎ القيمة المعادة يعاد كائن من النوع Hash يحوي عدادات مُخصصة داخل ...

يتحقق التابع member?‎ إذا كان مفتاحٌ معيَّن موجودًا في الكائن Hash المعطى. انتبه إلى أنَّ التابع include?‎ والتابع member?‎ لا يختبرا تساوي الأعضاء باستخدام المعامل ==كما تفعل غيرها من التوابع المحصية (enumerables). البنية العامة member?(key) → true or false المعاملات key المفتاح المراد التحقق من وجوده. القيمة المعادة تعاد القيمة true إذا كان المفتاح key موجود في الكائن Hash المعطى. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع member?‎: h = { "a" => 100, "b" => 200 } h.has_key?("a") #=> true h.has_key?("z") #=> false انظر ...

يعيد التابع 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 ...

يعيد التابع hash القيمة hash المقابلة للكائن Method الذي استُدعي معه. راجع أيضًا صفحة Object.hash. البنية العامة hash→ integer‎ القيمة المعادة يعاد عدد صحيح يمثِّل القيمة hash المقابلة للكائن Method المعطى. انظر أيضا التابع inspect: يعيد اسم التابع الأصلي (underlying method). مصادر قسم التابع hash‎ في الصنف Method‎ في توثيق روبي الرسمي.

يستدعي التابع each_value الكتلة المعطاة مرةً واحدةً لكل مفتاح من مفاتيح أزواج الكائن Hash الذي استدعي معه بعد تمرير قيمة كل زوج إليها. البنية العامة each_value {| value | block } → hsh each_value → an_enumerator القيمة المعادة يعاد ناتج تنفيذ الكتلة block على كل زوج من أزواج الكائن Hash المعطى بعد تمرير قيمة كل زوج إليها. إذا لم تُعطَ كتلة، يُعاد كائن من النوع enumerator بدلًا من ذلك.   أمثلة مثال على استعمال التابع each_value: h = { "a" => 100, ...

يزيل التابع shift زوجًا من قيمة-مفتاح من الكائن Hash الذي استدعي معه ويعيده في مصفوفة، أو يعيد القيمة الافتراضية لهذا الكائن إذا كان فارغًا. البنية العامة shift → anArray or obj القيمة المعادة تعاد مصفوفة من العنصرين [ key, value ] تحوي الزوج مفتاح-قيمة بعد حذفه من الكائن Hash المعطى، أو تعاد القيمة الافتراضية لهذا الكائن إن كان فارغًا. أمثلة مثال على استعمال التابع shift: h = { 1 => "a", 2 => "b", 3 => "c" } h.shift #=> ...

ينشئ التابع to_h جدولًا من النوع Hash يحوي نسخةً من متغيرات البيئة. البنية العامة to_hash → hash to_h → hash القيمة المعادة يعاد كائن من النوع Hash يحوي نسخةً من متغيرات البيئة. انظر أيضًا التابع to_a: يحول متغيرات البيئة إلى مصفوفة مكونة من مصفوفات فرعية تضم أسماء وقيم تلك المتغيرات.  التابع to_s: يعيد السلسلة النصية “ENV”. مصادر قسم التابع to_h في الصنف ENV في توثيق روبي الرسمي.

يستدعي التابع each_pair الكتلة المعطاة مرةً واحدةً لكل مفتاح من مفاتيح أزواج الكائن Hash الذي استدعي معه بعد تمرير مفتاح وقيمة الأزواج إليها. البنية العامة each {| key, value | block } → hsh each_pair {| key, value | block } → hsh each → an_enumerator each_pair → an_enumerator القيمة المعادة يعاد ناتج تنفيذ الكتلة block على كل زوج من أزواج الكائن Hash المعطى بعد تمرير مفتاح وقيمة الأزواج إليها. إذا لم تُعطَ كتلة، يُعاد كائن من النوع enumerator بدلًا من ذلك. أمثلة ...

يستدعي التابع each الكتلة المعطاة مرةً واحدةً لكل مفتاح من مفاتيح أزواج الكائن Hash الذي استدعي معه بعد تمرير مفتاح وقيمة الأزواج إليها. البنية العامة each {| key, value | block } → hsh each_pair {| key, value | block } → hsh each → an_enumerator each_pair → an_enumerator القيمة المعادة يعاد ناتج تنفيذ الكتلة block على كل زوج من أزواج الكائن Hash المعطى بعد تمرير مفتاح وقيمة الأزواج إليها. إذا لم تُعطَ كتلة، يُعاد كائن من النوع enumerator بدلًا من ذلك. أمثلة ...

يتحقق التابع compare_by_identity?‎ إذا كان الكائن Hash الذي استدعي معه سيقارن مفاتيحه بواسطة مُعرِّفاتهم. البنية العامة compare_by_identity? → true or false القيمة المعادة تعاد القيمة true إذا كان الكائن Hash الذي استدعي معه سيقارن مفاتيحه بواسطة مُعرِّفاتهم. خلا ذلك، تعاد القيمة false. انظر أيضا التابع compare_by_identity: يجعل الكائن Hash يقارن مفاتيحه بواسطة مُعرِّفاتها، أي أنَّها سوف تُعدُّ نفس الكائنات على أنَّها نفس المفاتيح. مصادر قسم التابع compare_by_identity?‎ في الصنف Hash في توثيق روبي الرسمي.

يعيد التابع reject كائن جديد من النوع Hash يتكون من الأزواج التي ترفضها الكتلة المعطاة. إذا لم تُعطَ أية كتلة، فسيُعاد كائن من النوع enumerator بدلًا من ذلك. البنية العامة reject {|key, value| block} → a_hash reject → an_enumerator القيمة المعادة يعاد كائن جديد من النوع Hash يتكون من العناصر التي تعيد الكتلة block المعطاة القيمة false معها. أمثلة مثال على استعمال التابع reject: h = { "a" => 100, "b" => 200, "c" => 300 } h.reject {|k,v| k < "b"} ...

يُبدِّل التابع replace‎ محتويات الجدول hash المعطى مكان محتويات متغيرات البيئة الحالية. البنية العامة replace(hash) → env المعاملات hash كائنٌ من النوع Hash يراد أن تُستبدَل متغيرات البيئة الحالية به. القيم المعادة يُعاد كائن من الصنف ENV يمثِّل البيئة الجديدة التي حلت مكان البيئة القديمة. انظر أيضًا التابع keys: يعيد جميع متغيرات البيئة في مصفوفة. التابع fetch‎: يجلب قيمة متغير بيئة ذي اسمٍ محدَّدٍ. مصادر قسم التابع replace في الصنف ENV في توثيق روبي الرسمي.

ينشئ التابع to_hash جدولًا من النوع Hash يحوي نسخةً من متغيرات البيئة. البنية العامة to_hash → hash القيمة المعادة يعاد كائن من النوع Hash يحوي نسخةً من متغيرات البيئة. انظر أيضًا التابع to_a: يحول متغيرات البيئة إلى مصفوفة مكونة من مصفوفات فرعية تضم أسماء وقيم تلك المتغيرات. التابع to_h: ينشئ جدولًا من النوع Hash يحوي نسخةً من متغيرات البيئة.  التابع to_s: يعيد السلسلة النصية “ENV”. مصادر قسم التابع to_hash في الصنف ENV في توثيق روبي الرسمي.

يعيد التابع hash القيمة hash (قيمة عددية مختصرة) بناءً على طول، ومحتوى، وترميز السلسلة النصية التي استدعي معها. البنية العامة hash → integer القيمة المعادة يعاد عدد صحيح يمثِّل القيمة hash المحسوبة للسلسلة النصية المعطاة (يؤخذ الطول والمحتوى والترميز بالحسبان). انظر أيضًا التابع bytes: يُعيد البايتات المقابلة لمحارف السلسلة النصية في مصفوفة. التابع codepoints: يُعيد نقاط الترميز المقابلة لمحارف السلسلة النصية في مصفوفة. مصادر قسم التابع hash‎ في الصنف String في توثيق روبي الرسمي.

يُعيد التابع named_captures جدول Hash يحتوي معلومات حول الالتقاطات المسماة (named captures) للتعبير النمطي الذي استُدعي معه. مفاتيح (keys) الجدول Hash هي أسماء الالتقاطات المعينة. أما قيم الجدول Hash فهي مصفوفات تضم فهارس الالتقاطات المسماة المقابلة. إذا لم يكن هناك أي التقاطات مسماة، فسيعاد جدول Hash فارغ. البنية العامة named_captures → hash‎ القيمة المعادة يعاد كائن من النوع Hash يحتوي معلومات حول الالتقاطات المسماة (named captures) للتعبير النمطي المعطى. أمثلة مثال على استخدام التابع named_captures‎: /(?<foo>.)(?<bar>.)/.named_captures #=> {"foo"=>[1], "bar"=>[2]} /(?<foo>.)(?<foo>.)/.named_captures #=> {"foo"=>[1, 2]}‎ /(.)(.)/.named_captures #=> ...

يعيد التابع size عدد الأزواج القيمة-المفتاح الموجودة في الكائن Hash الذي استدعي معه. البنية العامة size → integer القيمة المعادة يعاد عدد صحيح يمثِّل عدد الأزواج القيمة-المفتاح الموجودة في الكائن Hash المعطى. أمثلة مثال على استعمال التابع size: h = { "d" => 100, "a" => 200, "v" => 300, "e" => 400 } h.length #=> 4 h.delete("a") #=> 200 h.length #=> 3 انظر أيضا التابع length: يعيد ...

يعيد التابع latest_gc_info معلومات حول أحدث عملية جمعٍ للبيانات المهملة. البنية العامة latest_gc_info → {:gc_by=>:newobj} latest_gc_info(hash) → hash latest_gc_info(:major_by) → :malloc المعاملات hash كائن من النوع Hash. major_by: القيمة المعادة تعاد معلومات حول أحدث عملية جمعٍ للبيانات المهملة. انظر أيضا التابع enable: يفعِّل جمع البيانات المهملة، ويعيد القيمة true إذا كان جمع البيانات المهملة مُعطَّلًا مسبقًا. التابع malloc_allocated_size: يعيد حجم الذاكرة التي حُجزَت من قِبَل malloc()‎. مصادر قسم التابع latest_gc_info في الصنف GC في توثيق روبي الرسمي.

يزيل التابع clear جميع الأزواج قيمة-مفتاح من الكائن Hash الذي استدعي معه. البنية العامة clear → hsh القيمة المعادة يعاد الكائن Hash المعطة نفسه بعد إزالة جميع الأزواج قيمة-مفتاح منه. أمثلة مثال على استعمال التابع clear: h = { "a" => 100, "b" => 200 } #=> {"a"=>100, "b"=>200} h.clear #=> {} انظر أيضا التابع compact!‎: ...

يمرر التابع any?‎ كل زوج من مفتاح/قيمة من أزواج الكائن Hash المعطى إلى كتلة معينة ثم يعيد القيمة true إن أعادت الكتلة قيمة غير القيمة false أو nil. للمزيد من التفاصيل، اطلع على صفحة التابع Enumerable.any?‎. بنية العامة any? [{ |(key, value)| block }] → true or false القيمة المعادة تعاد القيمة true إن أعادت الكتلة block قيمة غير القيمة false أو nil عند تمرير كل زوج من أزواج الكائن Hash المعطى. انظر أيضا التابع compare_by_identity?‎: يتحقق إذا كان الكائن Hash الذي استدعي معه ...

يتحقق التابع eql?‎ إن كانت بنيتان تشيران إلى نفس مفتاح الجدول Hash أي إذا كان لهما نفس صنف البنية الفرعي، وكانت قيم أعضائهما متساوية (وفقًا للتابع Object.eql?‎). البنية العامة eql?(other)→ true or false‎ المعاملات other‎ البنية الأخرى المراد التحقق من تساويها مع البنية المعطاة. القيمة المعادة تعاد القيمة true إن كان المعامل other المعطى والبنية التي استُدعي التابع معها يشيران إلى نفس الجدول Hash، وإلا فستعاد القيمة false. انظر أيضًا التابع hash: يعيد القيمة hash استنادًا إلى محتويات البنية التي استدعيت ...

يبقي التابع keep_if كل زوج قيمة-مفتاح يحقق شرطًا معيَّنًا من أزواج الكائن Hash المعطى. البنية العامة keep_if {| key, value | block } → hsh keep_if → an_enumerator القيمة المعادة يعاد الكائن Hash المعطى بعد الإبقاء على الأزواج التي تُحقق الكتلة block بعد تمرير كل زوج من تلك الأزواج إليها (أي تُحذَف الأزواج التي تعاد القيمة false عند تنفيذ الكتلة معها). إذا لم تُعطَ الكتلة block، فسيُعاد كائن من النوع enumerator بدلًا من ذلك. انظر أيضا التابع delete_if: يحذف كل زوج قيمة-مفتاح يحقق شرطًا معيَّنًا من أزواج الكائن Hash المعطى. مصادر قسم التابع keep_if ...

يبحث التابع rassoc خلال الكائن Hash الذي استدعي معه عن طريق مقارنة القيمة التي مُمرِّرت إليه مع قيم ذلك الكائن باستخدام المعامل == ثم يعيد أول زوج قيمة-مفتاح متطابق. البنية العامة rassoc(obj) → an_array or nil المعاملات obj الكائن الذي سيُبحَث عنه في الكائن Hash المعطى. القيمة المعادة تعاد مصفوفة من عنصرين تحوي الزوج مفتاح/قيمة المطابقة للقيمة obj المبحوث عنها في الكائن Hash المعطى، أو تعاد القيمة nil إن لم يُعثر على شيء. أمثلة مثال على استعمال التابع rassoc: a = ...

يجعل التابع compare_by_identity الكائن Hash يقارن مفاتيحه بواسطة مُعرِّفاتها، أي أنَّها سوف تُعدُّ نفس الكائنات على أنَّها نفس المفاتيح. البنية العامة compare_by_identity → hsh القيمة المعادة يعاد الكائن Hash المعطى نفسه بعد يقارن مفاتيحه بواسطة مُعرِّفاتها. أمثلة مثال على استعمال التابع compare_by_identity: h1 = { "a" => 100, "b" => 200, :c => "c" } h1["a"] #=> 100 h1.compare_by_identity h1.compare_by_identity? #=> true h1["a".dup] #=> nil # different objects. h1[:c] ...

يتحقق التابع include?‎ إذا كان مفتاحٌ معيَّن موجودًا في الكائن Hash المعطى. انتبه إلى أنَّ التابع include?‎ والتابع member?‎ لا يختبرا تساوي الأعضاء باستخدام المعامل == كما تفعل غيرها من التوابع المحصية (enumerables). البنية العامة include?(key) → true or false المعاملات key المفتاح المراد التحقق من وجوده. القيمة المعادة تعاد القيمة true إذا كان المفتاح key موجودًا في الكائن Hash المعطى. أمثلة مثال على استعمال التابع include?‎: h = { "a" => 100, "b" => 200 } h.has_key?("a") #=> true h.has_key?("z") ...

يعيد التابع compact كائن Hash جديد يحوي جميع الأزواج قيم/مفاتيح للكائن الذي استدعي معه باستثناء الأزواج المعدومة (أي ذات القيمة nil). البنية العامة compact → new_hash القيمة المعادة يعاد كائن جديد من النوع Hash يحوي جميع الأزواج قيم/مفاتيح للكائن المعطى باستثناء الأزواج المعدومة (أي ذات القيمة nil). أمثلة مثال على استعمال التابع compact: h = { "a" => 100, "b" => 200 } #=> {"a"=>100, "b"=>200} h.clear ...

يحسب التابع hash قيمة التجزئة (hash value) الموافقة لجسم الكتلة proc التي استدعيت معه ثمَّ يعيدها. انظر أيضًا في صفحة التابع Object.hash. البنية العامة hash → integer القيم المعادة تُعاد قيمة التجزئة الموافقة لجسم الكتلة proc المعطاة. انظر أيضًا التابع ?lambda: يتحقَّق إذا كانت معالجة الوسائط صارمةً في الكائن Proc. التابع to_proc: يُعدُّ جزءًا من البروتوكول المستخدم في تحويل الكائنات إلى كائناتٍ من الصنف Proc. المعامل ===: يستدعي الكتلة بتمرير الكائن الواقع على يمينه كمعاملٍ للنسخة proc. التابع call: يستدعي ...

يزيل التابع compact!‎ جميع الأزواج قيمة/مفتاح المعدومة (أي ذات القيمة nil) من الكائن الذي استدعي معه. البنية العامة compact! → hsh or nil القيمة المعادة يعاد الكائن Hash المعطى نفسه بعد إزالة جميع الأزواج قيمة/مفتاح المعدومة (أي ذات القيمة nil)، أو تعاد القيمة nil إن لم تُجرَى أية تغييرات على ذلك الكائن. أمثلة مثال على استعمال التابع compact!‎: h = { a: 1, b: false, c: nil } h.compact! #=> { a: 1, b: false } انظر أيضا ...

يعكس التابع invert‎ بين أسماء وقيم متغيرات البيئة ثمَّ يعيدها في كائنٍ جديدٍ من النوع Hash. البنية العامة invert → Hash القيمة المعادة يعاد كائن جديد من النوع Hash يحوي قيم متغيرات البيئة كأسماء وأسماء متغيرات البيئة كقيم فيه. انظر أيضًا التابع inspect: يعيد محتوى البيئة (environment) في سلسلة نصية. التابع include?‎ : يتحقَّق إن كان هناك متغير بيئة ذي اسم محدَّد. مصادر قسم التابع invert في الصنف ENV في توثيق روبي الرسمي.

يعيد التابع flatten مصفوفة جديدة والتي تكون تسطيح أحادي الأبعاد للكائن Hash الذي استدعي معه. أي أنَّ لكل مفتاح أو قيمة تكون مصفوفة، تستخرج عناصرها إلى مصفوفة جديدة. على عكس Array.flatten، لا يُسطِّح هذا التابع بشكل عَودي (recursively) افتراضيًا. يمكن تحديد مستوى عودية التسطيح عبر تمرير قيمة إلى التابع. البنية العامة flatten → an_array flatten(level) → an_array المعاملات level عدد صحيح يحدد مستوى عودية التسطيح. القيمة المعادة تعاد مصفوفة جديدة والتي تكون تسطيح أحادي الأبعاد للكائن Hash المعطى. أمثلة مثال على استعمال ...

يحول التابع to_h الكائن القابل للتعداد المعطى إلى كائن من النوع Hash. البنية العامة to_h(*args) → hash المعاملات args الوسائط المراد استعمالها في عملية التحويل. القيمة المعادة يعاد كائن جديد من النوع Hash يحوي قائمة من الأزواج مفتاح/قيمة الناتجة عن تحويل الكائن القابل للتعداد المعطى. أمثلة مثال على استعمال التابع to_h: %i[hello world].each_with_index.to_h # => {:hello => 0, :world => 1} انظر أيضًا التابع to_a: يحول الكائن القابل للتعداد إلى مصفوفة. مصادر قسم التابع to_h في الصنف Enumerable في توثيق روبي ...

يبحث التابع assoc ضمن الكائن Hash عن طريق موازنة الكائن المُمرَّر إليه بمفاتيحه باستخدام المعامل == ثم يعيد الزوج قيمة-مفتاح (مصفوفة من عنصرين) أو nil إذا لم يعثر على أي تطابق. البنية العامة assoc(obj) → an_array or nil المعاملات obj الكائن الذي يمثِّل المفتاح المراد البحث عنه ضمن الكائن Hash المعطى. القيمة المعادة تعاد مصفوفة من عنصرين تحوي الزوج قيمة-مفتاح إن عُثِر على المفتاح المطابق لقيمة المعامل obj، أو تعاد القيمة nil لم يعثر على أي تطابق. أمثلة مثال على استعمال ...

يربط التابع store قيمة محددة مع مفتاح محدد في الكائن Hash الذي استدعي معه. إن كان المفتاح موجود مسبقًا وكان مرتبط بقيمة، فستتغير هذه القيمة إلى القيمة المعطاة الجديدة. وإن لم يكن موجودًا، فسيُنشَأ ويُربَط بالقيمة المعطاة ويضاف إلى الكائن. البنية العامة store(key, value) → value المعاملات key المفتاح الذي يراد ربط القيمة value المعطاة به. value القيمة التي ستُربَط بالمفتاح key. القيمة المعادة تعاد القيمة value نفسها بعد ربطها بالمفتاح key. أمثلة مثال على استعمال التابع store: h = { "a" => 100, "b" => ...

التابع rehash‎ لا يفعل أي شيء، فهو موجود لأغراض التوافقية مع الصنف Hash. البنية العامة rehash انظر أيضًا الصنف Hash. مصادر قسم التابع rehash في الصنف ENV في توثيق روبي الرسمي.

يحول التابع Hash المعامل المُمرَّر إليه إلى جدول Hash. ويعيد جدول Hash فارغًا إن كان المعامل المعطى يساوي nil أو []. البنية العامة Hash(arg) → hash‎ المعاملات arg‎ الكائن المراد تحويله إلى جدول Hash. القيمة المعادة يعاد كائن من النوع Hash يحوي قيمة المعامل arg عبر تحويلها باستدعاء التابع arg.to_hash، أو يكون فارغًا إن كان arg يساوي nil أو []. أمثلة مثال على استخدام التابع Hash‎: Hash([]) #=> {} Hash(nil) ...

يعيد التابع fetch قيمة من الكائن Hash لمفتاح معين. إذا كان المفتاح غير موجود، هناك عدة خيارات متاحة لتطبيقها وهي: مع عدم تمرير معاملات أخرى غير المفتاح، سيُرمَى الاستثناء KeyError. إذا مُرِّرت قيمة أخرى بعد المفتاح، فستُعاد هذه القيمة على أساس أنها قيمة افتراضية. إذا أعطيت الكتلة الاختيارية، فستُنفَّذ وتُعاد نتيجتها. البنية العامة fetch(key [, default] ) → obj fetch(key) {| key | block } → obj المعاملات key المفتاح المراد جلب القيمة المرتبطة به في الكائن Hash. default القيمة الافتراضية التي ...

يجلب التابع each‎ أسماء وقيم متغيرات البيئة بالتتابع، ويرسلها فُرادى إلى الكتلة البرمجية المعطاة. في حال عدم تمرير كتلة برمجية إلى التابع، فسيعيد كائنًا من النوع Enumerator. البنية العامة each { |name, value| } → Hash each → Enumerator each_pair { |name, value| } → Hash each_pair → Enumerator القيمة المعادة يعاد كائن من النوع Hash بعد تمرير اسم وقيمة كل متغير من متغيرات البيئة إلى الكتلة المعطاة على حدة، أو يعاد كائن من النوع Enumerator في حال عدم تمرير أي كتلة برمجية. ...

يشبه الصنف ENV الجداول Hash كثيرًا ويُستعمل للوصول إلى متغيرات البيئة. توابع الصنف العامة (Public Class Methods) [] يعيد هذا المعامل قيمة متغير بيئة محدَّد في سلسلة نصية، أو يعيد القيمة nil في حال لم يكن ذلك المتغير موجودًا. [] يضبط هذا المعامل عندما يُستعمَل بالشكل ENV[name] = value‎ قيمة متغير البيئة ذي الاسمname إلى القيمة value. إذا كانت القيمة value المعطاة تساوي nil، فسيُحذَف متغير البيئة ذاك. assoc يعيد مصفوفةً تحوي اسم وقيمة متغير بيئة ذي اسم محدَّد، أو يعيد القيمة nil في حال لم يكن ذلك المتغير موجودًا. clear يحذف ...

يعيد التابع named_captures الجدول Hash الذي يحوي العناصر المتطابقة وجزء التعبير النمطي الذي طابقها من التعبير النمطي الكلي. مفاتيح (keys) الجدول Hash هي أسماء الأجزاء المطابقة المعينة (التعبير النمطي المطابق)، والقيمة المقابلة فيه هي سلاسل نصية تمثل آخر جزء متطابق ناجح للمجموعة المقابلة لذلك التعبير النمطي. البنية العامة named_captures → hash‎ القيمة المعادة يعاد الجدول Hash الذي يحوي العناصر المتطابقة وجزء التعبير النمطي الذي طابقها من التعبير النمطي الكلي. أمثلة مثال على استخدام التابع named_captures‎: m = /(?<a>.)(?<b>.)/.match("01") m.named_captures #=> {"a" => ...

يبدل التابع gsub!‎ قيمة (أو قيم) محدَّدة مكان جميع الأنماط المتطابقة في السلسلة النصية التي استدعي معها. هذا التابع مماثل تمامًا للتابع gsub ولكن يعدل على السلسلة المعطاة نفسها. البنية العامة gsub!(pattern, replacement) → str or nil gsub!(pattern, hash) → str or nil gsub!(pattern) {|match| block } → str or nil gsub!(pattern) → an_enumerator المعاملات pattern يكون عادةً تعبيرًا نمطيًّا. إن كان سلسلة نصية، فستُفسَّر أية محارف خاصة بالتعبيرات النمطية الموجودة فيها حرفيًّا؛ أي '‎\\d' سيطابق خط مائل عكسي يتبعه الحرف 'd' مباشرةً ...