نتائج البحث

يُحوِّل التابع id2ref_ معرِّف الكائن (id) إلى مرجعٍ للكائن. لا يجب استدعاؤه على معرِّف كائنٍ مُرِّر كمعامل ٍ إلى مُنهِي (finalizer). البنية العامة _id2ref(object_id) → an_object المعاملات object_id رقم معرِّف الكائن. القيم المعادة يُعاد الكائن المُسند إلى المُعرِّف object_id. أمثلة مثالٌ عن استخدام التابع id2ref_: s = "I am a string" #=> "I am a string" r = ObjectSpace._id2ref(s.object_id) #=> ...

يكرر التابع times‎ تنفيذ الكتلة البرمجية المعطاة عددًا محدَّدًا من المرات مع تمرير قيم عددية ابتداءً من الصفر وحتى العدد الذي يسبق العدد المعطى. في حال عدم تمرير أي كتلة برمجية، فسيُعاد كائن من النوع Enumerator. البنية العامة times {|i| block } → self times → an_enumerator‎ القيمة المعادة في حال تمرير كتلة برمجية، يعاد ناتج تنفيذ هذه الكتلة بعد تمرير أعداد تبدأ من الصفر وحتى القيمة int - 1 (إذ يكون int هو العدد المعطى) إليها. أما ...

(PHP 4, PHP 5, PHP 7) تنهي break تنفيذ حلقات for أو foreach أو while أو do-while أو بنية switch. تأخذ break معاملًا عدديًا اختياريًا يُحدّد من خلاله عدد البنى المتداخلة التي‏ يجب إيقاف تنفيذها. القيمة الافتراضية لهذا المعامل هي 1، والذي يعني إيقاف تنفيذ البنية الحالية فقط. <?php $arr = array('one', 'two', 'three', 'four', 'stop', 'five'); while (list(, $val) = each($arr)) { if ($val == 'stop') { break; /* يمكن أيضًا كتابة /* ...

يكرر التابع upto‎ تنفيذ الكتلة البرمجية المعطاة مع تمرير الأعداد تصاعديًا بدايةً من العدد الذي استُدعي معه وحتى العدد المعطى. في حال عدم تمرير أي كتلة برمجية، فسيُعاد الكائن Enumerator. البنية العامة upto(limit) {|i| block } → self upto(limit) → an_enumerator‎ المعاملات limit‎ الحد الأقصى لعملية التكرار. القيمة المعادة في حال تمرير كتلة، فسيعاد ناتج تنفيذ هذه الكتلة مع تمرير العدد المعطى في كل مرة تصاعديًّا حتى الوصول إلى العدد limit، وإلا فسيعاد الكائن Enumerator. أمثلة مثال على استخدام التابع ...

ينشئ التابع دالة تجميع aggregate function معرّفة من قبل المستخدم. البنية العامة create_aggregate(name, num_params, aggregate_class) المعاملات name اسم دالة التجميع المراد إنشاؤها. num_params عدد المعاملات التي تستقبلها الدالة (يمكن تعيين القيمة ‎-1 لهذا المعامل لتستقبل الدالة أي عدد من المعاملات). aggregate_class صنف تجميع يجب أن يتضمّن تابع step، والذي يأخذ المعامل num_params والذي يحدّد عدد المعاملات في الدالة التي ينشئها التابع (يمكن تعيين القيمة ‎-1 لهذا المعامل لتستقبل الدالة أي عدد من المعاملات)، وتابع finalize والذي سيعيد النتيجة النهائية من ...

يحسب المعامل % باقي قسمة عددين أحدهما على الآخر. إحدى فوائد استعمال هذا المعامل هي إبقاء قيمة متغير ضمن مجال محدد (مثل حجم مصفوفة). البنية العامة remainder = dividend % divisor; المعاملات remainder متغير. الأنواع المسموح بها هي: عدد صحيح، أو عدد عشري، أو عدد عشري مضاعف. dividend متغير أو ثابت يمثل المقسوم. الأنواع المسموح بها هي: عدد صحيح. divisor متغير أو ثابت يمثل المقسوم عليه. الأنواع المسموح بها هي: عدد صحيح. أمثلة مثالٌ على استعمال المعامل %: int x ...

يحسب المعامل % باقي قسمة عددين أحدهما على الآخر. إحدى فوائد استعمال هذا المعامل هي إبقاء قيمة متغير ضمن مجال محدد (مثل حجم مصفوفة). البنية العامة remainder = dividend % divisor; المعاملات remainder متغير. الأنواع المسموح بها هي: عدد صحيح، أو عدد عشري، أو عدد عشري مضاعف. dividend متغير أو ثابت يمثل المقسوم. الأنواع المسموح بها هي: عدد صحيح. divisor متغير أو ثابت يمثل المقسوم عليه. الأنواع المسموح بها هي: عدد صحيح. أمثلة مثالٌ على استعمال المعامل %: int x ...

يعيد التابع collect مصفوفة جديدة تحوي نتائج تنفيذ الكتلة المعطاة دفعةً واحدةً مع كل عنصر من عناصر المُعدِّد الذي استدعي معه. إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا من النوع Enumerator. البنية العامة collect { |obj| block } → array collect → an_enumerator القيمة المعادة تعاد مصفوفة تحوي نتائج تنفيذ الكتلة المعطاة دفعةً واحدةً مع كل عنصر من عناصر المُعدِّد المعطى، أو يعاد كائن من النوع Enumerator إن لم تُعطَ أية كتلة. أمثلة مثال على استعمال التابع collect: (1..4).map { |i| ...

يعيد التابع map مصفوفة جديدة تحوي النتائج المقابلة لكل عنصر من عناصر الكائن القابل للتعداد المعادة من الكتلة المعطاة بعد تمريره إليها. إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا من النوع Enumerator. البنية العامة map { |obj| block } → array map → an_enumerator القيمة المعادة تعاد مصفوفة جديدة تحوي النتائج المقابلة لكل عنصر من عناصر الكائن القابل للتعداد المعادة من الكتلة block بعد تمريره إليها. إن لم تُعطَ أية كتلة، فسيعاد كائن من النوع Enumerator. أمثلة مثال على استعمال التابع map: ...

تنبيه: هذه تقنيّة تجريبيّة، انظر جدول دعم المتصفّحات قبل استخدام هذا التّابع في شيفرة إنتاجيّة. يعيد التّابع Document.caretPositionFromPoint‎()‎ كائنًا من النّوع CaretPosition يحتوي على عقدة DOM ومكان علامة الإقحام (caret) وحدود محارف (character offset) العلامة داخل هذه العقدة. البنية العامة var caretPosition = document.caretPositionFromPoint(float x, float y); المعاملات x الإحداثيّ الأفقيّ لنقطة ما. y الإحداثيّ العمودي لنقطة ما. القيمة المعادة كائن من النّوع CaretPosition. مثال يقوم المثال التّالي بإدخال فراغ سطريً (line break) أينما ضغطت. جزء HTML: <p>Lorem ipsum dolor ...