نتائج البحث

يعيد التابع sum المجموع التحقُّقي (checksum) ذي الحجم n بت لحروف السلسلة النصية التي استدعيت معه؛ هذا المجموع عبارة عن مجموع القيم الثنائية لكل بايت من بايتات السلسلة وفق المقياس: 1 - n**2، حيث يمكن تغيير قيمة n التي تأخذ افتراضيًا القيمة 16. البنية العامة sum(n=16) → integer المعاملات n عدد صحيح يمثل قيمة n في المقياس 1- 2**n المستعمل في حساب المجموع التحقُّقي، ويأخذ افتراضيًا القيمة 16. القيمة المعادة يُعاد المجموع التحقُّقي لمحارف السلسلة النصية المعطاة. انظر أيضًا التابع ...

يُطلق الاستثناء RangeError عند إعطاء تعبير نمطي غير صالح. إذا نفَّذنا السطر البرمجي التالي: Regexp.new("?") فسيُطلَق الاستثناء RangeError بالشكل التالي: RegexpError: target of repeat operator is not specified: /?/ مصادر صفحة الصنف RegexpError في توثيق روبي الرسمي.

عندما تستدعي تابعًا، فإنّك تمرّر رسالة لكائن معيّن لأجل تنفيذ مهمّة معيّنة، ويتمّ ذلك في لغة روبي كالتّالي: my_method() لاحظ أنّ استخدام الأقواس المنحنية هنا اختياريّ: my_method المعتمد في هذا التّوثيق أن تُستخدّم الأقواس عند وجود المعامِلات لإزالة الالتباس، إلا في حالة وجود فرق بين وجود الأقواس وحذفها. هذا القسم يغطّي فقط كيفيّة استدعاء التوابع، وستُشرَح كيفيّة تعريف التّوابع في قسم آخر. المستقبِل المستقبِل (Receiver) الافتراضي في لغة روبي هو self وهو الذي يُستخدَم في حال عدم تحديد أيّ مستقبل آخر. ولأجل ...

يذهب التابع seek إلى موضع محدد في المجلد الذي استٌدعي معه. البنية العامة seek( integer ) → dir ينبغي أن يكون الوسيط integer عددًا معادًا من التابع tell. المعاملات integer  عددٌ معاد من التابع tell. القيمة المعادة يعاد الكائن Dir المعطى بعد إعادة ضبط موضع المؤشر فيه. أمثلة مثال عن استخدام التابع seek على المجلد testdir الذي يحوي ملفين عاديين (config.h و main.rb)، والمجلد الأب (..)، والمجلد نفسه (.): d = Dir.new("testdir") #=> #<Dir:0x401b3c40> d.read ...

يُعيد التابع getutc توقيتًا جديدًا يمثل التوقيت الذي استُدعي معه بالتوقيت العالمي الموحد (UTC). البنية العامة getutc → new_time‎ القيمة المعادة يعاد توقيتٌ جديدٌ يمثل التوقيت المعطى بالتوقيت العالمي الموحد (UTC). أمثلة مثال على استخدام التابع getutc‎: t = Time.local(2000,1,1,20,15,1) #=> 2000-01-01 20:15:01 -0600 t.gmt? #=> false y = t.getgm ...

يعيد التابع key اسم متغير البيئة الذي يملك قيمة محدَّدة. في حال لم تكن تلك القيمة موجودة، فسيعيد التابع القيمة nil. البنية العامة key(value) → name المعاملات value قيمة متغير البيئة المراد البحث عن الاسم المتغير المسندة إليه. القيمة المعادة يعاد اسم متغير البيئة ذا القيمة value. في حال لم تكن القيمة موجودة، فستُعاد القيمة nil. انظر أيضًا التابع has_key?‎: يتحقَّق إن كان هناك متغير بيئة باسم محدَّد. التابع has_value?‎: يتحقَّق إن كان هناك متغير بيئة يملك قيمة محدَّدة. التابع key?‎: ...

يبحث التّابع find عن ترميزٍ باسمٍ محدّد. الأسماء التي يقبلها هذا التّابع هي الاسم الأساسي والاسم البديل الخاص بالتّرميز بما في ذلك الأسماء البديلة التالية: "external": يمثل الترميز الخارجي الافتراضي (default external encoding). "internal": يمثل الترميز الداخلي الافتراضي (default external encoding). "locale": يمثل الترميز المحدد في المحلية (locale encoding). "filesystem": يمثل ترميز نظام الملفات (filesystem encoding). البنية العامة find(string) → enc المعاملات string سلسلة نصية تمثل اسم الترميز المراد البحث عنه. القيم المعادة يعاد الترميز ذو الاسم string في حال ...

يبحث التابع max عن قيمة أكبر عنصر من عناصر الكائن القابل للتعداد الذي استدعي معه ثم يعيده. إن أعطيت كتلة، فسيعيد التابع أكبر عنصر يحقق شرطًا معيَّنًا؛ أي تُجرَى عملية الموازنة عبر المعامل <=> بحسب العملية التي تنفذها الكتلة على كل عنصر والقيمة المقابلة التي تعيدها. البنية العامة max → obj max { |a, b| block } → obj max(n) → array max(n) { |a, b| block } → array المعاملات n إن أعطي هذا المعامل، فسيُعاد أكبر n عنصر في مصفوفة. تُرتَّب العناصر آنذاك ...

يعيد التابع size‎ عدد البتات في تمثيل الآلة (machine representation) للعدد الذي استُدعي معه. الناتج يتعلق بالآلة المستخدمة. البنية العامة size → int‎ القيمة المعادة يعاد عد صحيح يمثِّل عدد البتات في تمثيل الآلة للعدد الذي استُدعي معه. أمثلة مثال على استخدام التابع size‎: 1.size #=> 8 -1.size #=> 8 2147483647.size ...

يبحث التابع bsearch باستخدام البحث الثنائي (binary search) عن قيمة من مصفوفة تحقق شرطًا منطقيًّا محددًا ويستغرق ‎O(log n)‎، إذ n حجم المصفوفة. يوجد وضعان لاستعمال هذا التابع هما: وضع البحث عن الحد الأدنى (find-minimum mode)، ووضع البحث العام (find- any mode). في كلتا الحالتين، يجب أن تكون عناصر المصفوفة مرتبةً بالتوافق مع الكتلة البرمجية المحدَّدة. في وضع البحث عن الحد الأدنى (يعدُّ هذا خيارًا جيدًا لحالات الاستخدام الاعتياديَّة)، يجب أن تعيد الكتلة البرمجية القيمة true أو القيمة false دومًا ...