نتائج البحث

يجري المعامل <=> عملية الموازنة بين كائنين ثم يعيد الناتج الذي يشير إلى العلاقة بينهما. البنية العامة module <=> other_module→ -1, 0, +1, or nil‎ يجري المعامل <=> عملية الموزانة ثمَّ يعيد إحدى القيم ‎-1 أو 0 أو ‎+1 أو nil اعتمادًا على ما إذا كان module يتضمن other_module، أو كانا متساويين، أو إذا كان module متضمَّنًا في other_module. تعاد القيمة nil إن لم تكن بين module و other_module أية علاقة، أو إن لم يكن other_module وحدة من الصنف Module، أو ...

يُقارن المعامل <=> بين سلسلتين نصيتين ثم يعيد القيم 1-، أو 1، أو 0 إذا ما كانت السلسلة النصية الأولى أكبر أو أصغر أو تساوي السلسلة النصية الثانية على التوالي. يعيد المعامل القيمة nil إذا كانت القيمتين غير قابلتين للمقارنة. إذا اختلفت سلسلتين نصيتين في الطول، وكانتا متطابقتين حتى نقطة معينة، فإنَّ السلسلة الأطول من بعد هذه النقطة هي السلسلة الأكبر. البنية العامة string <=> other_string → -1, 0, +1, or nil المعاملات str السلسلة النصية الأولى. other_str السلسلة النصية ...

يجري المعامل & العملية AND المنطقية على القيمة true وقيمة الكائن المعطى، ويُعيد القيمة false إن كان الكائن يساوي nil أو false. البنية العامة true & obj → true or false‎ القيمة المعادة تعاد القيمة false إن كان obj يساوي nil أو false، أو تعاد القيمة true خلاف ذلك. انظر أيضًا المعامل |: يجري العملية OR المنطقية على القيمة true وقيمة الكائن المعطى ويُعيد القيمة true دومًا.   المعامل ^: يجري العملية XOR المنطقية على القيمة true وقيمة الكائن المعطى ويعيد ...

يجري المعامل ‎+ عملية الجمع بين عددين عقديين. البنية العامة cmp + numeric → complex المعاملات cmp عدد عقدي يمثل الطرف الأول في عملية الجمع. numeric عدد عقدي أو غير عقدي يمثل الطرف الثاني في عملية الجمع. القيمة المعادة يعاد عددٌ عقديٌ ناتج عن جمع العددين cmp و numeric. أمثلة أمثلة عن استخدام المعامل +: Complex(2, 3) + Complex(2, 3) #=> (4+6i) Complex(900) + Complex(1) #=> (901+0i) Complex(-2, 9) + Complex(-9, 2) ...

ينفذ المعامل ^ العملية XOR الثنائية بين بتات العددين المعطيين. البنية العامة int ^ other_int → integer القيمة المعادة يعاد عددٌ صحيحٌ يمثل ناتج تنفيذ العملية XOR على البتات المتقابلة في العددين int و other_int. أمثلة مثال على استخدام المعامل ^: 20 ^ 3 #=> 23 25 ^ 2 #=> 27 انظر أيضا المعامل &: ينفذ العملية AND بين بتات العددين المعطيين.  مصادر قسم المعامل ^ في الصنف Integer‎ في توثيق روبي ...

يعيد المعامل == القيمة true إن كان العدد العشري الواقع على يساره يساوي القيمة الواقعة على يمينه. على خلاف التابع Numeric.eql?‎ الذي يشترط أن يكون القيمة الثانية الواقعة على يمين المعامل من النوع Float أيضًا. البنية العامة float == obj → true or false القيمة المعادة تعاد القيمة true إن كان العدد العشري float يساوي القيمة obj عدديًا. ملاحظة: نتيجة NaN == NaN غير مُعرَّفة، لذا تُعاد قيمة تعتمد على التنفيذ. أمثلة مثال على استخدام المعامل ==: 20 == 20 ...

يعيد المعامل **‎ ناتج عملية رفع عدد عشري (الأساس) إلى قوة عدد محدد (الأس). البنية العامة float ** other → float المعاملات float عدد عشري يمثل الطرف الأول (الأساس) في للعملية. other عدد يمثل الطرف الثاني (الأس) للعملية. القيمة المعادة يعاد عدد عشري يمثِّل ناتج عملية رفع المعامل float إلى قوة المعامل other. أمثلة مثال على استخدام التابع **‎: 2.0**3 #=> 8.0 انظر أيضا المعامل *: يعيد ناتج عملية الضرب بين عددين. التابع modulo: يعيد باقي عملية القسمة بين عدد عشري وعدد آخر. مصادر ...

يتحقق المعامل == إن كان لبنية ما نفس الصنف الفرعي ونفس قيم الأعضاء مقارنةً ببنية أخرى. البنية العامة struct == other → true or false‎ القيمة المعادة تُعاد القيمة true إن كان للبنية other نفس الصنف الفرعي، وكان لها نفس قيم الأعضاء مقارنة بالبنية struct، وإلا فستُعاد القيمة false. أمثلة مثال على استخدام المعامل ==‎: Customer = Struct.new(:name, :address, :zip) joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345) joejr = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345) jane ...

يعيد المعامل *‎ ناتج عملية الضرب بين عددين. نوع الكائن الناتج يتعلق بنوع العدد الثاني الذي ستُجرَى عليه العملية. البنية العامة int * numeric → numeric_result  المعاملات int عدد صحيح يمثل الطرف الأول في للعملية. numeric  عدد يمثل الطرف الثاني للعملية. القيمة المعادة يعاد ناتج عملية الضرب بين العددين numeric و int. أمثلة مثال على استخدام المعامل *: 20 * 3 #=> 60 6 * 3.4 ...

يعيد المعامل ‎<‎ القيمة true إن كانت الوحدة Module التي تقع على يساره صنفًا فرعيًّا من الوحدة التي تقع على يمينه، أو يعيد القيمة nil إن لم تكن بينهما أية علاقة (فكر في العلاقة من منظور تعريف الأصناف: "الصنف A < الصنف B" يستلزم "A < B"). البنية العامة mod < other→ true, false, or nil‎ القيمة المعادة تعاد القيمة true إن كان mod صنفًا فرعيًّا من other، أو تعاد القيمة nil إن لم تكن بينهما أي علاقة. خلا ذلك، ...

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

أصناف الاستثناءات (Exception Classes) تنحدر كلّ أصناف الاستثناءات في لغة Kotlin من الصنف Throwable حيث يوجد لكلِّ استثناءٍ رسالةٌ للإعلام به وتتبُّع تكديسي (stack trace) وسببٌ اختياريّ. ويُستخدَم التعبير throw لرمي كائن استثناءٍ بالشكل: throw MyException("Hi There!") أمّا تعبير try فهو مُستخدَمٌ لكشف الاستثناء كما في الشيفرة: try { // شيفرة } catch (e: SomeException) { // معالجات الاستثناء } finally { // قسم اختياريّ } ومن الممكن أن يحتوي الاستثناء أكثر من قسمٍ واحدٍ من catch أو ...

يتلخَّصُ الاستخدام الرئيسيّ لأصناف الثوابت المتعدَّدة في قدرتها على تعريف الاستخدام (implementing) للثوابت المتعدًّدة الحافظة للنوع (type-safe)، ويُصرَّح عنها بالشكل: enum class Direction { NORTH, SOUTH, WEST, EAST } إذ يُعدُّ كلُّ ثابتٍ فيها كائنًا (object)، ويُفصل فيما بينها بالفاصلة , . التهيئة (Initialization) لمّا كان كلّ ثابتٍ في صنف الثوابت المتعدِّدة (enum) يُعدُّ كائنًا فيمكن إجراء التهيئة كما يلي: enum class Color(val rgb: Int) { RED(0xFF0000), ...

يعدُّ الصنف Enum الصنف الأساس لكل أصناف الترقيم (enum classes). إن أردت الاطلاع على معلومات أوسع حول أصناف الترقيم، فاقرأ هذا المرجع. البنية العامة Enum(name: String, ordinal: Int) المعاملات name سلسلة نصية. ordinal عدد صحيح. أمثلة في الشيفرة الآتية، ننشئ نسخة من الصنف Enum باسم ColorEnum مكونًا من أربعة ثوابت: Red و Blue و Green و Orange ثم نطبع قيمة الثابت Red: fun main(args: Array<String>) { print(ColorEnum.Red) // Red } enum class ColorEnum(val colorCode: Int) { Red(2), Blue(11212), Green(21212), ...

يعدُّ الصنف Enum الصنف الأساس لكل أصناف الترقيم (enum classes). إن أردت الاطلاع على معلومات أوسع حول أصناف الترقيم، فاقرأ هذا المرجع. البنية العامة Enum(name: String, ordinal: Int) المعاملات name سلسلة نصية. ordinal عدد صحيح. أمثلة في الشيفرة الآتية، ننشئ نسخة من الصنف Enum باسم ColorEnum مكونًا من أربعة ثوابت: Red و Blue و Green و Orange ثم نطبع قيمة الثابت Red: fun main(args: Array<String>) { print(ColorEnum.Red) // Red } enum class ColorEnum(val colorCode: Int) { Red(2), Blue(11212), Green(21212), ...

إن كلَّ عنصرٍ في Kotlin يعد كائنًا إذ يمكن استدعاء الدوال (member functions) والخاصّيّات (properties) عبر أي متغيِّر (variable)، ولبعض الأنواع تمثيلها الداخلي الخاص بها؛ فعلى سبيل المثال تُمثَّل الأعداد والمحارف والقيم المنطقية (boolean) كقيمٍ أساسيّةٍ أثناء التشغيل (runtime) ولكنها بالنسبة للمستخدم مجرّد أصنافٍ عادية، وتناقش هذه الصفحة الأنواع الرئيسيّة للبيانات في Kotlin وهي: الأعداد، والمحارف، والقيم المنطقية (boolean)، والمصفوفات، والسلاسل النصيّة. الأعداد (Numbers) تتعامل لغة Kotlin مع البيانات العدديّة بطريقةٍ مماثلةٍ للغة Java ولكن بفوارق بسيطة، فلا تدعم مثلًا ...

تنشِئ الدالة Array()‎ البانية مصفوفةً بحجم size مُحدَّدٍ، حيث يُحسَب كلُّ عنصرٍ فيها عبر استدعاء الدالة init المُحدَّدة، والتي تُعيد عنصرًا في المصفوفة بحسب الفهرس (index) المُعطى. البنية العامة Array(size: Int, init: (Int) -> T) المعاملات size عدد صحيح يمثل حجم المصفوفة المراد إنشاؤها. init دالةٌ تستدعى لحساب قيمة كل عنصر من عناصر المصفوفة المراد إنشاؤها. القيم المعادة مصفوفة بالحجم size تتكوّن من العناصر الناتجة عن الدالة init. أمثلة ينشِئ التابع في الشيفرة الآتية مصفوفةً بستة عناصر زوجيّة (نتيجة ضرب ...

تنشِئ الدالة Array()‎ البانية مصفوفةً بحجم size مُحدَّدٍ، حيث يُحسَب كلُّ عنصرٍ فيها عبر استدعاء الدالة init المُحدَّدة، والتي تُعيد عنصرًا في المصفوفة بحسب الفهرس (index) المُعطى. البنية العامة Array(size: Int, init: (Int) -> T) المعاملات size عدد صحيح يمثل حجم المصفوفة المراد إنشاؤها. init دالةٌ تستدعى لحساب قيمة كل عنصر من عناصر المصفوفة المراد إنشاؤها. القيم المعادة مصفوفة بالحجم size تتكوّن من العناصر الناتجة عن الدالة init. أمثلة ينشِئ التابع في الشيفرة الآتية مصفوفةً بستة عناصر زوجيّة (نتيجة ضرب ...

تعريف الحزم (Package) يُكتب توصيف الحزمة (package) في بداية الملف المصدريّ (source file) بالشكل الآتي: package my.demo import java.util.* // ... ولا يُشترط التوافق ما بين الحزمة (package) والمجلد الذي توجد فيه (directory)، إذ من الممكن أن تتوضع الملفات المصدريّة عشوائيًّا في نظام الملفات. المزيد عن الحزم (packages). تعريف الدوال (Function) إن كانت الدالة بمتحولين من نوع Int وتعيد قيمةً بنوع Int أيضًا، فسيصبح تعريفها بالشكل: fun sum(a: Int, b: Int): Int {   return a + b } أما الشيفرة الآتية فهي لتعريف دالةٍ باسم sum ...

تعيد الدالة associateBy()‎ خريطةً (map) مكونة من الأزواج "مفتاح/قيمة"، إذ يكون المفتاح (key) هو الناتج الذي تعيده الدالة keySelector الممررة إليها وتكون القيمة (value) المقابلة لذلك المفتاح هي إمَّا عناصر المصفوفة أو المجموعة المعطاة أو الناتج الذي تعيده الدالة valueTransform الممررة.  إن كان لعنصرين نفس المفتاح (key) بعد تطبيق الدالة keySelector، فإنَّ الأخير هو الذي سيُضاف إلى الخريطة. تحافظ الخريطة المُعادة على نفس ترتيب التكرار الخاص بالمصفوفة أو المجموعة الأصليَّة. البنية العامة إن استدعيت الدالة associateBy()‎مع مصفوفة، فستعيد خريطةً (map) ...

توسع هذه الواجهة الصنف MatchGroupCollection عبر تعريف طريقةٍ لجلب المجموعات المتطابقة (matched groups) عن طريق أسمائها عندما يدعم Regex ذلك. interface MatchNamedGroupCollection : MatchGroupCollection الإصدار المطلوب: kotlin 1.1. الدوال (Functions) get تعيد هذه الدالة نسخةً من الصنف MatchGroup إن كانت المجموعة التي تحمل الاسم المُمرّر إليها متطابقَة. الدوال الموروثة (Inherited Functions) get تعيد هذه الدالة نسخةً من الصنف MatchGroup إن كانت المجموعة التي تحمل الاسم المُمرّر إليها متطابقَة. الخاصيات الإضافية (Extension Properties) indices تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection). الدوال ...

تمثل الواجهة MatchGroupCollection مجموعةً (collection) من الفئات المرصودة (captured groups) عند إجراء مطابقة واحدة لتعبير نمطي ما. حجم المجموعة يساوي groupCount + 1، إذ يمثل groupCount عدد الفئات (groups) في التعبير النمطي. الفئات مُفهرسة بدءًا من 1 وحتى groupCount، والفئة ذات الفهرس 0 تقابل كل ما تطابق. يمكن أن يساوي بعض عناصر المجموعة القيمة العدمية (null) في حال كانت الفئة المقابلة في التعبير النمطي اختيارية، ولم يُرصَد أي تطابق من قبل تلك الفئة. interface MatchGroupCollection : Collection<MatchGroup?> الدوال get تعيد هذه ...

تمثل الواجهة MatchGroupCollection مجموعةً (collection) من الفئات المرصودة (captured groups) عند إجراء مطابقة واحدة لتعبير نمطي ما. حجم المجموعة يساوي groupCount + 1، إذ يمثل groupCount عدد الفئات (groups) في التعبير النمطي. الفئات مُفهرسة بدءًا من 1 وحتى groupCount، والفئة ذات الفهرس 0 تقابل كل ما تطابق. يمكن أن يساوي بعض عناصر المجموعة القيمة العدمية (null) في حال كانت الفئة المقابلة في التعبير النمطي اختيارية، ولم يُرصَد أي تطابق من قبل تلك الفئة. interface MatchGroupCollection : Collection<MatchGroup?> الدوال get تعيد هذه ...

توسع هذه الواجهة الصنف MatchGroupCollection عبر تعريف طريقةٍ لجلب المجموعات المتطابقة (matched groups) عن طريق أسمائها عندما يدعم Regex ذلك. interface MatchNamedGroupCollection : MatchGroupCollection الإصدار المطلوب: kotlin 1.1. الدوال (Functions) get تعيد هذه الدالة نسخةً من الصنف MatchGroup إن كانت المجموعة التي تحمل الاسم المُمرّر إليها متطابقَة. الدوال الموروثة (Inherited Functions) get تعيد هذه الدالة نسخةً من الصنف MatchGroup إن كانت المجموعة التي تحمل الاسم المُمرّر إليها متطابقَة. الخاصيات الإضافية (Extension Properties) indices تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection). الدوال ...

تُتيح لغة Kotlin إجراءَ مجموعةٍ مُعرَّفة مسبقًا من العمليات على أنواع البيانات المختلفة وذلك باستخدام رموزٍ ثابتةٍ تعتمدها لغة Kotlin مثل الرمز + أو الرمز * وتختلف فيما بينها بالأولويّة (precedence)، حيث توجد دالةٌ (إما دالة من الصنف [member] أو دالة إضافيّة [extension]) باسمٍ ثابتٍ لكلّ معاملٍ مُعرَّف بحسب النوع (نوعٌ يساريٌّ للعمليات الثنائيّة [binary operations] ونوع وسائط [argument type] للعمليات الأحاديّة [unary operations])، ويجب تحديد الدوال التي تحتوي على تحميلٍ زائدٍ للمعاملات بالمُحدَّد operator، تناقش الصفحة الاصطلاحات (conventions) التي ...

تعرِض هذه الصفحة أنماط كتابة الشيفرات المُتعارَف عليها (conventions) من قِبل مبرمجي لغة Kotlin. تطبيق دليل التنسيق (Applying the Style Guide) لضبط المُنسِّق IntelliJ formatter بما يتوافق مع هذا الدليل يُنصَح بتثبيت إضافة Kotlin بالإصدار 1.2.20 (أو أي إصدارٍ أحدث) وضبط المّحرِّر بالانتقال إلى الإعدادات (Settings) ثمّ المُحرِّر (Editor) ثم نمط الشيفرة (Code Style) ثم Kotlin واختر "ضبط من..." Set from…"‎" في الزاوية اليمنى العُلويَّة ومن القائمة اختر الخيار Predefined style/Kotlin style guide. وللتأكد من تنسيق الشيفرة وفقًا لدليل Kotlin ...

تعرِض هذه الصفحة أنماط كتابة الشيفرات المُتعارَف عليها (conventions) من قِبل مبرمجي لغة Kotlin. تطبيق دليل التنسيق (Applying the Style Guide) لضبط المُنسِّق IntelliJ formatter بما يتوافق مع هذا الدليل يُنصَح بتثبيت إضافة Kotlin بالإصدار 1.2.20 (أو أي إصدارٍ أحدث) وضبط المّحرِّر بالانتقال إلى الإعدادات (Settings) ثمّ المُحرِّر (Editor) ثم نمط الشيفرة (Code Style) ثم Kotlin واختر "ضبط من..." Set from…"‎" في الزاوية اليمنى العُلويَّة ومن القائمة اختر الخيار Predefined style/Kotlin style guide. وللتأكد من تنسيق الشيفرة وفقًا لدليل Kotlin ...

تُستخدم الكلمة المفتاحيّة class للتصريح (declaration) عن الصنف بالصيغة الآتية (اسم الصنف Invoice): class Invoice { } ويحتوي التصريح على اسم الصنف (class name) وترويسة الصنف (class header) (والتي تُحدِّد معاملات النوع والباني الأساسيّ ...إلخ.) وبُنية الصنف (class body) محاطةً بالقوسين {}، وإن كلًا من ترويسة الصنف وبُنيته اختياريتان؛ فإذا كان الصنف خاليًا لا حاجة للأقواس، مثل: class Empty الباني (Constructor) يوجد لكلّ صنف في لغة Kotlin بانٍ رئيسيّ (primary) واحدٌ وبانٍ -أو أكثر- ثانويّ (secondary)، إذ يُعدُّ الباني الرئيسيّ جزءًا من ...

تُنشَأ بعض الأصناف بهدف تخزين البيانات فيها بشكلٍ أساسيّ، وبالتالي فإنّ كلّ ما تقوم به هذه الأصناف من وظائف يرتبط بالبيانات، وهذا ما يُسمى بأصناف البيانات في لغة Kotlin وتُعرَّف بالمُحدِّد data كما يلي: data class User(val name: String, val age: Int) قواعد عامّة يقوم المُترجِم في الأصناف من هذه النوع باشتقاق العناصر (deriving members) الآتية من كلِّ الخاصّيّات المُعرَّفة في الباني الأساسيّ (primary constructor): كلًا من equals()‎ و hashCode()‎ الدالة toString()‎ بشكلها ‎"User(name=John, age=42‎)‎"‎ الدوال بالصيغة componentN() functions بما ...

تعرِض هذه الصفحة عددًا من التعابير الاصطلاحيّة المستخدَمة بكثرةٍ في لغة Kotlin، ولأيّ اصطلاحٍ جديدٍ لم يُذكَر فيمكنك تعديل هذه الصفحة لإضافته. إنشاء كائنات نقل البيانات DTO:‏ Data Transfer Objects (الكائنات POJO/POCO) ليكن الصنف (class) الآتي باسم Customer: data class Customer(val name: String, val email: String) وله التوابع الوظيفيّة (functional methods) الآتية: توابع getter (وتوابع setter في حالة المتحولات من النوع var) لكافة الخاصّيّات (properties) equals()‎ hashCode()‎ toString()‎ copy()‎ component1()‎ و component2()‎ ...إلخ. وذلك لكافة الخاصّيّات (properties) في الصنف (راجع أصناف البيانات ...

الأنواع Nullable والأنواع Non-Null يهدف نظام الأنواع في Kotlin إلى الحدِّ من أخطار القيمة الفارغة null في الشيفرات، إذ إنّ أحد الأخطاء الأكثر شيوعًا في لغات البرمجة -بما فيها لغة Java- هو أنّ محاولة الوصول إلى مرجعيّةٍ تحتوي على القيمة null سيؤدي إلى حدوث استثناءٍ مرجعيّ (reference exception)، ويُدعى هذا الاستثناء في لغة Java باسم NullPointerException أو NPE اختصارًا، أمّا Kotlin فهي تحدُّ من هذا الاستثناء ليقتصر على الحالات الآتية: استدعاءٌ صريحٌ بالشكل: throw NullPointerException()‎ استخدام المعامل !! (كما سيُشرح لاحقًا) ...

المعاملين is و ‎!is تدعم لغة Kotlin ميّزة التحقُّق من توافق الكائن مع أحد الأنواع أثناء التنفيذ، وذلك بالاعتماد على المُعامِل is أو صيغته المنفيّة ‎!is كما في الشيفرة: if (obj is String) { print(obj.length) } if (obj !is String) { // !(obj is String) مكافئ للصيغة print("Not a String") } else { print(obj.length) } التحويلات الذكية (Smart Casts) لا حاجة في كثيرٍ من الأحيان لجعل التحويل صريحًا (explicit) في لغة Kotlin لأنّ المترجم (compiler) يتتبَّع ...

التصريح عن الدوال (Function Declarations) يُصرَّح عن الدوال في لغة Kotlin باستخدام الكلمة المفتاحيّة fun كما يلي: fun double(x: Int): Int { return 2 * x } استخدام الدوال (Function Usage) يكون استدعاء الدوال كما في أيّ لغة برمجةٍ أخرى بالشكل: val result = double(2) أمّا استدعاء الدوال من الأصناف فيعتمد على المعامل . كما في الشيفرة: Sample().foo() // إنشاء كائنٍ من الصنف واستدعاء الدالة عبره المعاملات (Parameters) تُعرَّف المعاملات بالصيغة المُعتمدَة في لغة Pascal وهي name: type ، ...

تعرض الثابتة DEFAULT_PARAMS وسائط الآلة الافتراضية (VM) الاولية (default ). لاحظ أنّ تغيير تلك القيم لا يؤثر على طريقة تشغيل الآلة الافتراضية. المواصفات ليست مستقرة، ويجب أن لا تعتمد على هذه القيمة. انظر أيضا صفحة الصنف RubyVM. صفحة الثابتة OPTS. مصادر قسم الثابتة DEFAULT_PARAMS في الصنف RubyVM‎ في توثيق روبي الرسمي.

يعيد معامل الفهرسة [] البت الموجودة عند الموضع n في التمثيل الثنائي للعدد الصحيح المعطى. يشير [0]int إلى البت الأقل أهمية (least significant bit). البنية العامة int[n] → 0, 1 القيمة المعادة يعاد البت الموجودة عند الموضع n في التمثيل الثنائي للعدد int؛ أي لا تتجاوز القيمة المعادة عن 1 أو 0. أمثلة مثال على استخدام معامل الفهرسة []: a = 0b11001100101010 30.downto(0) {|n| print a[n] } #=> 0000000000000000011001100101010 a = 9**15 50.downto(0) {|n| print a[n] } #=> 000101110110100000111000011110010100111100010111001 انظر أيضا المعامل >>: يزيح العدد الصحيح ...

يمثل الثابت PI ثابت الدائرة pi (يرمز له رياضيًّا بالرمز π). هذا العدد هو عدد عشري ويساوي تقريبًا القيمة 3.14. البنية العامة Math::PI مثال مثال على استخدام الثابت PI: Math::PI #=> 3.141592653589793 انظر أيضا الثابت e: يمثل القيمة e الرياضية. مصادر قسم الثابتة PI في الصنف Math‎ في توثيق روبي الرسمي.

انظر صفحتي التابعين options و new. مصادر قسم الثابتة IGNORECASE في الصنف Regexp‎ في توثيق روبي الرسمي.

يُستعمَل المعامل ‎- لنفي العدد العقدي (القيمة السالبة منه أن كان موجبًا). البنية العامة -cmp → complex المعاملات cmp العدد العقدي الذي سيُنفَى (يصبح سالبًا إن كان موجبًا). القيمة المعادة يعاد عددٌ عقديٌ ناتج عن نفي العدد العقدي cmp (سالبٌ إذا كان موجبًا أو العكس). أمثلة أمثلة عن استخدام معامل النفي ‎-: -Complex(1, 2) #=> (-1-2i) أنظر أيضًا المعامل ‎*: يجري عملية الضرب على الأعداد العقدية. المعامل **‎: يجري عملية الأسّ (exponentiation) على الأعداد العقدية. المعامل +‎ : يجري عملية الجمع على ...

يعيد التابع binding  كائنًا من النوع Binding، والذي يصف ويحدد ارتباطات المتغيرات والتوابع لحظة الاستدعاء. يمكن استخدام هذا الكائن عند استدعاء eval لتنفيذ الأمر الذي تم تقييمه (evaluated command) في هذه البيئة. البنية العامة binding → a_binding‎ القيمة المعادة يعاد كائنٌ من النوع Binding. أمثلة مثال على استخدام التابع binding‎: def get_binding(param) binding end b = get_binding("hello") eval("param", b) #=> "hello" ‎ انظر أيضا الصنف Binding. مصادر قسم التابع binding‎ في الصنف Kernel‎ في توثيق روبي الرسمي.

يعيد التابع __method__  الاسم الذي أعطي للتابع الحالي عند تعريفه على شكل رمز (Symbol). في حال استدعائه خارج أي تابع، فسيعيد nil. البنية العامة __method__→ symbol‎ القيمة المعادة يعاد الاسم الذي أعطي للتابع الحالي عند تعريفه على شكل رمز (Symbol). في حال استدعائه خارج أي تابع، فسيعيد nil. انظر أيضا التابع __callee__: يعيد اسم التابع الحالي على شكل رمز (Symbol). وفي حال استدعائه خارج أي تابع، فسيعيد nil. التابع __dir__: يعيد المسار المطلق الأساسي لمجلد الملف الذي استُدعي هذا التابع منه. مصادر ...

يطبع التابع print الكائنات الممررة إليه بالتتابع على المجرى stdout$. إذا كان فاصل حقل الخرج (‎$,‎) يخالف nil، فسيظهر محتواه بين الحقول. إذا كان فاصل سجل الخرج (‎$\‎‎‎) يخالف nil، فسيوضع في نهاية المُخرجات. في حال لم تعطَ أية وسائط، فستُطبَع _$. ستُحول الكائنات غير النصية باستخدام التابع to_s. البنية العامة print(obj, ...) → nil‎ المعاملات obj‎ الكائن المراد طباعته. ...‎ كائنات أخرى. القيمة المعادة تعاد القيمة nil. أمثلة مثال على استخدام التابع print‎: print "cat", [1,2,3], 99, "\n" $, = ...

يعيّن المعامل [] قيمة عنصر ذي فهرس محدد، أو قيم عدة عناصر تبدأ عند عنصر محدد وتمتد عددًا محددًا من العناصر، أو قيم عدة عناصر موجودة عند مجال محدد في مصفوفة. إن كانت الفهارس تشير إلى عناصر تقع خارج نطاق المصفوفة المعطاة، فستُوسَّع المصفوفة تلقائيًا. تُدرج العناصر في المصفوفة عند الفهرس start إن كانت قيمة الوسيط length تساوي 0. إن مُرِّرت قيم سالبة للفهارس، فسيُحسَب موضع العنصر بدءًا من نهاية المصفوفة، إذ تمثِّل القيمة ‎-1 فهرس العنصر الأخير. بالنسبة للوسيطين ...

يعيد التابع Rational ناتج العملية x/y إن مُرر عددين إليه أو عدد جذري (Rational) إن مُرِّر معامل وحيد فقط. قواعد الصياغة النصية: string form = extra spaces , rational , extra spaces ; rational = [ sign ] , unsigned rational ; unsigned rational = numerator | numerator , "/" , denominator ; numerator = integer part | fractional part | integer part , fractional part ; denominator = digits ; integer part = digits ; fractional part = "." , digits , [ ( "e" ...

تتصرف الكائنات MatchData بشكل مشابه للمصفوفات، إذ يمكن الوصول إليها باستخدام تقنيات فهرسة المصفوفات العادية. التعبير mtch[0]‎ مكافئ للمتغير الخاص ‎‎$&‎، لذلك فهو يعيد كامل السلسلة النصية المُطابقة بينما تعيد التعابير mtch[1]‎ و mtch[2]‎ ...إلخ. قيم العناصر المتطابقة سابقًا (تدعى "المراجع الخلفية" [backreferences]) من أجزاء النمط الموجودة بين قوسين. البنية العامة mtch[i]→ str or nil mtch[start, length]→ array mtch[range] → array mtch[name]→ str or nil‎ القيمة المعادة يعيد التعبير mtch[0]‎ كامل السلسلة النصية المُطابقة بينما تعيد التعابير mtch[1]‎ و mtch[2]‎ ...إلخ. قيم ...

محدد أكثر من خاصية Multiple Attribute Selector الوصف يختار هذا المحدِّد العناصر التي تطابق جميع مرشِّحات خاصِّيَّة معينة. jQuery( "[attributeFilter1][attributeFilter2][attributeFilterN]" )‎ أُضيف مع الإصدار: 1.0. attributeFilter1 مرشِّح خاصِّيَّة. attributeFilter2 مرشِّح خاصِّيَّة آخر والذي يقلص العناصر المراد تحديدها. attributeFilter3 مرشِّح خاصِّيَّة آخر، ويمكن استعمال عددٍ من المرشِّحات بحسب الحاجة. أمثلة إيجاد جميع المدخلات التي تملك الخاصِّيَّة id وتنتهي قيمة الخاصِّيَّة name لها بالقيمة man ثمَّ ضبط قيمتها: <!doctype html> <html lang="ar"> <head> <meta charset="utf-8"> <title>attributeMultiple مثالٌ عن محدد الخاصيات المتعددة</title> ...

ينفذ التابع loop الكتلة البرمجية المعطاة بشكل متكرر. في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف enumerator بدلاً من ذلك. يؤدي اطلاق الاستثناء StopIteration داخل الكتلة إلى إيقاف الحلقة التكرارية. في هذه الحالة، سيعيد التابع loop قيمة "النتيجة" المخزنة في الاستثناء. البنية العامة loop { block } loop→ an_enumerator‎ القيمة المعادة يؤدي اطلاق الاستثناء StopIteration داخل الكتلة إلى إعادة قيمة "النتيجة" المخزنة في الاستثناء. أما في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف enumerator. أمثلة مثال على ...

يحول التابع at_exit  الكتلة البرمجية المعطاة إلى كائن من النوع Proc (وبالتالي يربطه في لحظة الاستدعاء) ويسجله لأجل تنفيذه عند نهاية البرنامج. في حالة تسجيل عدة معالجات (handlers)، فستٌنفّذ بترتيب معاكس لتسجيلها. البنية العامة at_exit { block } → proc‎ القيمة المعادة يعاد كائن من النوع Proc. أمثلة مثال على استخدام التابع at_exit‎: def do_at_exit(str1) at_exit { print str1 } end at_exit { puts "cruel world" } do_at_exit("goodbye ") exit الناتج: goodbye cruel world انظر أيضا التابع abort: ينهي التنفيذ على الفور عبر استدعاء Kernel.exit(false)‎. ...

يضبط (Controls) التابع trace_var تعقّبات (tracing) تعيين المتغيرات العامة. البنية العامة trace_var(symbol, cmd ) → nil trace_var(symbol) {|val| block } → nil‎ يحدد الوسيط المعطى symbol المتغير (إمَّا على شكل سلسلة نصية أو معرف رمز [symbol identifier]). يتم تنفيذ الأمر cmd (الذي قد يكون سلسلةً نصيةً أو كائن من النوع Proc أو كتلةً برمجيةً) كلما تم تعيين المتغير ثم تتلقى الكتلة أو الكائن Proc القيمة الجديدة للمتغير كوسيط. المعاملات symbol‎ يحدد المتغير. cmd‎ التعليمة المراد تنفيذها كلما تم تعيين المتغير. القيمة المعادة ...

انظر صفحتي التابعين options و new. مصادر قسم الثابتة NOENCODING في الصنف Regexp‎ في توثيق روبي الرسمي.

يعيد التابع autoload?‎ اسم الملف المراد تحميله إذا سُجّل للتحميل عند الوصول إلى وحدة محدَّدة عبر التابع autoload. البنية العامة autoload?(name)→ String or nil‎ المعاملات name سلسلة نصية تمثل اسم الوحدة. القيمة المعادة تعاد سلسلة نصية تمثل اسم الملف المراد تحميله عند الوصول إلى الوحدة name، أو تعاد القيمة nil إن لم يكن هنالك أي ملف مُسجَّل. أمثلة مثال على استخدام التابع autoload?‎: autoload(:B, "b") autoload?(:B) #=> "b" ‎ انظر أيضا ...

يعيد التابع caller_locations مكدس التنفيذ (execution stack) الحالي كمصفوفة تحتوي كائنات تعقب عكسي (backtrace location objects). انظر صفحة Thread::Backtrace::Location لمزيد من المعلومات. البنية العامة caller_locations(start=1, length=nil) → array or nil caller_locations(range)→ array or nil‎ يحدد الوسيط الاختياري start عدد مدخلات المكدس الأولية التي ستُحذف من أعلى المكدس. ويمكن استخدام الوسيط length اختياري ثاني لتحديد عدد المدخلات التي ستُعاد من المكدس. يعيد التابع القيمة nil إن كان الوسيط start أكبر من حجم مكدس التنفيذ الحالي. اختياريًا، يمكنك تمرير مجال range، والذي سيؤدي إلى ...

يوازن المعامل <=> بين الكائنات File::Stat من ناحية أوقات تعديل كل منها. البنية العامة stat <=> other_stat → -1, 0, 1, nil القيمة المعادة تعاد القيم 1-، أو 0، أو 1 إن كان الكائن stat أصغر من أو يساوي أو أكبر من الكائن other_stat. تعاد القيمة nil إن لم يكن الكائن other_stat من النوع File::Stat. أمثلة مثال على استعمال المعامل <=>: f1 = File.new("f1", "w") sleep 1 f2 = File.new("f2", "w") f1.stat <=> f2.stat #=> -1 انظر أيضا التابع new: ينشئ ...

يكافئ التابع chop  التعبير ‎($_.dup).chop!‎ باستثناء أنّ nil لا تُعاد أبدًا. انظر صفحة !String.chop. هذا التابع متوفر فقط عند تحديد خيار سطر الأوامر ‎-‎p/-n. البنية العامة chop→ $_‎ القيمة المعادة يعاد ناتج التعبير ‎($_.dup).chop!‎. انظر أيضا التابع chomp: يكافئ التعبير ‎$_ = $_.chomp( string)‎. مصادر قسم التابع chop‎ في الصنف Kernel‎ في توثيق روبي الرسمي.

يحول التابع Float الوسيط المعطى إلى عدد عشري (Float). البنية العامة Float(p1) القيمة المعادة يعيد التابع Float عددا عشريا (Float). أمثلة مثال على استخدام التابع Float: Float(1239); #=> 1239.0 Float("12.39"); #=> 12.39 Float(25/6); #=> 4.0 انظر أيضًا التابع Integer: يحول الوسيط المعطى إلى عدد صحيح (Integer). مصادر قسم التابع Float في الصنف Kernel‎ في توثيق روبي الرسمي.

يعلّق التابع sleep المهمة الفرعية (thread) الحالية لعدد محدَّد من الثواني ثم يعيد عدد الثواني الفعلية (بعد تقريبه) الذي توقفت فيها المهمة الفرعية، والذي قد يكون أقل من العدد المطلوب إن استدعت مهمة فرعية أخرى التابع Thread.run. وفي حال استدعاء التابع sleep دون تمرير أي شيء إليه، فسيرسل المهمة الفرعية إلى النوم بشكل دائم. البنية العامة sleep([duration]) → integer‎ المعاملات duration‎ مدة تعليق المهمة الفرعية. قد يكون أي نوع عددي، بما في ذلك الأعداد العشري التي من النوع Float. القيمة ...

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

يمثِّل الثابت GMP_VERSION النسخة GMP المُحمّلة. انظر أيضا صفحة الصنف Integer. مصادر قسم الثابت GMP_VERSION في الصنف Integer في توثيق روبي الرسمي.

يحول التابع Integer المعامل المُمرَّر إليه إلى عدد صحيح (Integer). البنية العامة Integer(arg, base=0) → integer‎ تُحوّل الأنواع العددية مباشرة (مع اقتطاع الفواصل العشرية [floating point numbers]). المعامل base المٌعطى يمثل أساس التمثيل النصي للأعداد الصحيحة. إن كان arg من النوع String، وفي حال عدم تمرير الوسيط base أو كان يساوي الصفر، فسيتم احتساب مؤشرات الأساس (0 و 0b و 0x). في جميع الحالات، يجب أن تكون السلاسل النصية متوافقة تمامًا مع التمثيل الرقمي. يختلف هذا السلوك عن سلوك التابع String.to_i. ...

ينشئ التابع open كائنًا من النوع IO متصلًا بالمجرى أو الملف أو العملية الفرعية (subprocess) المحددة. البنية العامة open(path [, mode [, perm]] [, opt]) → io or nil open(path [, mode [, perm]] [, opt]) {|io| block } → obj‎ في حال إعطاء كتلة، فستُسدعَى بتمرير كائن من النوع IO كوسيط إليها، والذي سيُغلق تلقائيًا عند الانتهاء من تنفيذ الكتلة ثم سيعاد الناتج. إذا بُدئ الوسيط path بشرطة عمودية ("|") ، فسيتم إنشاء عملية فرعية (subprocess)، متصلة بالمُستدعي (caller) بواسطة ...

يكافئ التابع chomp التعبير ‎$_ = $_.chomp( string)‎. انظر صفحة String.chomp. هذا التابع متوفر فقط عند تحديد خيار سطر الأوامر ‎-‎p/-n. البنية العامة chomp→ $_ chomp(string) → $_‎ القيمة المعادة يعاد ناتج التعبير ‎$_ = $_.chomp( string)‎. انظر أيضا التابع chop: يكافئ التعبير ‎($_.dup).chop!‎ ، باستثناء أنّ nil لا تُعاد أبدًا. مصادر قسم التابع chomp‎ في الصنف Kernel‎ في توثيق روبي الرسمي.

يكافئ التابع printf التعبير التالي: io.write(sprintf(string, obj, ...))‎ أو التعبير التالي: $stdout.write(sprintf(string, obj, ...))‎ البنية العامة printf(io, string [, obj ... ]) → nil printf(string [, obj ... ]) → nil‎ المعاملات io‎ مجرى من النوع IO ستكتب عليه البيانات. string‎ السلسلة النصية المراد طباعتها. obj ...‎ كائنات أخرى يراد طباعتها. القيمة المعادة تعاد القيمة nil بعد طباعة السلسلة string على مخرج الخرج القياسي أو المجرى io إن أعطي. انظر أيضا التابع print: يطبع الكائنات الممرة إليه بالتتابع على المجرى stdout$. ...

يضبط التابع srand بذرة مولد الأعداد شبه العشوائية (system pseudo-random number generator)، إذ يعين Random::DEFAULT ويعطيها قيمة العدد المُعطى ثم يعيد قيمة البذرة السابقة. في حال عدم تمرير أي عدد إلى التابع، يحدد التابع srand بذرةً للمولد باستخدام مصدر العشوائية (entropy) الذي يوفره نظام التشغيل، إن كان متاحًا (وهو ‎/dev/urandom على أنظمة يونكس أو مُوفِّر خوارزمية التشفير RSA على نظام ويندوز)، والذي يُدمَج مع الوقت، ومعرف العملية (pid)، ورقم التسلسل. يمكن استخدام التابع srand لضمان تكرار تسلسلات الأعداد شبه العشوائية ...

يكافئ التابع puts التعبير: $stdout.puts(obj, ...)‎ أي يطبع السلسلة النصية المُمرَّرة إليه على مجرى الخرج القياسي. البنية العامة puts(obj, ...) → nil‎ المعاملات obj‎ الكائن المراد طباعته. ...‎ كائنا أخرى يراد طباعتها. القيمة المعادة تعاد القيمة nil بعد تنفيذ العملية. انظر أيضا التابع format: يعيد السلسلة النصية المعطاة بعد تنسيقها بشكل معين. التابع print: يطبع الكائنات الممررة إليه بالتتابع على المجرى stdout$. التابع putc: أي يطبع القيمة الممرَّرة إليه على مجرى الخرج القياسي. مصادر قسم التابع puts‎ في الصنف Kernel‎ في توثيق روبي ...

يكتب التابع p في مجرى الخرج القياسي للبرنامج ناتج التعبير obj.inspect مباشرة متبوعًا بسطر جديد لكل كائن من الكائنات الممررة إليه. البنية العامة p(obj) → obj p(obj1, obj2, ...) → [obj, ...] p() → nil‎ المعاملات obj‎ كائن الذي ستطبق عليه العملية. obj1 الكائن الأول الذي ستطبق عليه العملية. obj2 الكائن الثاني الذي ستطبق عليه العملية. ... الكائنات الأخرى التي ستطبق عليه العملية. القيمة المعادة يعاد ناتج التعبير obj.inspect. أمثلة مثال على استخدام التابع p‎: S = Struct.new(:name, :state) s ...

يعيد التابع __callee__ اسم التابع الحالي على شكل رمز (Symbol). وفي حال استدعائه خارج أي تابع، فسيعيد nil. البنية العامة __callee__→ symbol‎ القيمة المعادة يعاد اسم التابع الحالي على شكل رمز (Symbol). وفي حال استدعائه خارج أي تابع، فسيعيد nil. انظر أيضا التابع __dir__: يعيد المسار المطلق القانوني لمجلد الملف الذي استُدعي هذا التابع منه. التابع __method__: يعيد  الاسم الذي أعطي للتابع الحالي عند تعريفه على شكل رمز (Symbol). مصادر قسم التابع ‎__callee__‎ في الصنف Kernel‎ في توثيق روبي الرسمي.

يتحقق التابع block_given?‎ إذا كان yield سينفذ كتلةً برمجيةً في السياق الحالي. الشكل iterator?‎‎ صار شبه مهمل. البنية العامة block_given?→ true or false‎ القيمة المعادة تُعاد القيمة true إذا كان yield سينفذ كتلة برمجية في السياق الحالي. أمثلة مثال على استخدام التابع block_given?‎: def try if block_given? yield else "no block" end end try #=> "no ...

يعيد التابع format السلسلة النصية المعطاة بعد تنسيقها بشكل معين. البنية العامة format(format_string [, arguments...] )→ string‎ المعاملات format_string‎ السلسلة التي تحدد التنسيق. داخل سلسلة التنسيق format_string، ستُنسخ كل المحارف إلى السلسلة النصية الناتجة باستثناء سلسلة التنسيق (format sequences). صيغة سلسلة محارف التنسيق تأخذ الشكل التالي: %[flags][width][.precision]type‎ تتألف سلسلة محارف التنسيق من علامة النسبة المئوية، متبوعةً بثلاث حقول اختيارية هي: flags و width و precision ثم تنتهي بمحرف يحدد حقل النوع type. يتحكم حقل النوع في كيفية تأويل الوسيط المقابل sprintf، ...

تحتوي الثابتة OPTS على خيارات الآلة الافتراضية (vm). انظر أيضا صفحة الصنف RubyVM. صفحة الثابتة DEFAULT_PARAMS. مصادر قسم الثابتة stat‎ في الصنف RubyVM‎ في توثيق روبي الرسمي.

يستبدل التابع exec العملية (process) الحالية عبر تشغيل الأمر الخارجي المعطى والذي يمكن أن يأخذ أحد الأشكال التالية: الأمر الوصف exec(commandline)‎ أحد أوامر سطر الأوامر (command line) والذي يُمرّر إلى الصدفة (shell) القياسية. exec(cmdname, arg1, ...) ‎ اسم أمر (command name) ووسيط واحد أو أكثر (بدون صدفة). exec([cmdname, argv0], arg1, ...)‎ اسم أمر وكائن argv، مع إمكانية إضافة وسائط أخرى (بدون صدفة shell). في الشكل الأول، تؤخذ السلسلة النصية باعتبارها أمرًا يراد تنفيذه في سطر أوامر، ثم تعمل الصدفة على ...

يسجل التابع autoload اسم الملف المعطى لكي يُحمّل (باستخدام Kernel::require) في المرة الأولى التي يتم الوصول فيها إلى وحدة محدَّدة. البنية العامة autoload(module, filename)→ nil‎ المعاملات module سلسلةٌ نصيةٌ أو رمزٌ (symbol) يمثِّل اسم الوحدة. filename اسم الملف. المراد تحميله عن الوصول إلى الوحدة module. القيمة المعادة تعاد القيمة nil عند نجاح العملية. أمثلة مثال على استخدام التابع autoload‎: autoload(:MyModule, "/usr/local/lib/modules/my_module.rb") ‎ انظر أيضا التابع autoload?‎: يعيد اسم الملف المراد تحميله إذا سُجّل للتحميل عند الوصول إلى وحدة محدَّدة عبر التابع autoload. ...

يقيّم (Evaluates) التابع eval تعبيرات روبي الموجودة في سلسلة نصية. البنية العامة eval(string [, binding [, filename [,lineno]]]) → obj‎ إذا أعطي المعامل binding، فسيُجرَى التقييم في السياق الخاص به. في حال تمرير المعاملين الاختياريين filename و lineno، فسيُستخدمان عند الإبلاغ عن أخطاء الحاصلة في الصياغة. المعاملات string‎ سلسلة نصية تحتوي تعبيرات روبي. binding‎ كائن من النوع Binding. في حال تمريره، فسيُجرى التقييم في السياق الخاص به. filename‎ يُستخدم عند الإبلاغ عن أخطاءٍ في الصياغة. lineno‎ يُستخدم عند الإبلاغ عن ...

يأخذ التابع compile وسيطًا source (انظر فقرة البنية العامة)، والذي هو سلسلة نصية (String) تحتوي على أكواد برمجية لروبي ويُصرّفها (compiles) إلى كائن من النوع InstructionSequence. يأخذ التابع compile اختياريا الوسائطً file و path و line التي تمثل اسم الملف والمسار المطلق ورقم السطر الأول من كود روبي في المصدر source، والتي هي بيانات وصفية (metadata) تُربط بالكائن المُعاد iseq. يتم استخدام الوسيط options، والذي يمكن أن تكون قيمته true أو false أو قاموسًا (Hash)، لتعديل السلوك الافتراضي لمصرّف روبيRuby سلسلة التعليمات ...

يحدد التابع trap معالج الإشارات (handling of signals). الوسيط الأول يمثل اسم إشارة (سلسلة نصية مثل "SIGALRM" أو "SIGUSR1" وغير ذلك) أو رقم إشارة. يمكن حذف الأحرف "SIG" من اسم الإشارة. تحدد التعليمة command أو الكتلة المعطاة الكود البرمجي المراد تشغيله عند إطلاق الإشارة. إذا كانت التعليمة تساوي السلسلة النصية "IGNORE" أو "SIG_IGN" ، فسيتم تجاهل الإشارة. أما إذا كانت تساوي "DEFAULT" أو "SIG_DFL" ، فسيُستدعى معالج روبي الافتراضي. لكن إذا كانت تساوي "EXIT" ، فستنهي الإشارة البرنامج النصي. إذا ...

يعيد التابع __dir__ المسار المطلق الأساسي (canonicalized absolute path) لمجلد الملف الذي استُدعي هذا التابع منه. هذا يعني أنه سيتم استبيان الوصلات الرمزية في المسار. إذا كان __FILE__ يساوي nil، فسيعيد التابع __dir__ القيمة nil أيضًا. القيمة المعادة تساوي File.dirname(File.realpath(__FILE__))‎. البنية العامة __dir__→ string‎ القيمة المعادة يعاد المسار المطلق الأساسي لمجلد الملف الذي استُدعي هذا التابع منه. إذا كان __FILE__ يساوي nil، فستُعاد القيمة nil. انظر أيضا التابع __callee__: يعيد اسم التابع الحالي على شكل رمز (Symbol). التابع __method__: يعيد الاسم الذي ...

يعيد التابع String المعامل المعطى على شكل سلسلة نصية (String). يحاول التابع String في البدء استدعاء التابع to_str ثم التابع to_s. البنية العامة String(arg)→ string‎ المعاملات arg القيمة المراد تحويلها إلى سلسلة نصية. القيمة المعادة تعاد سلسلة نصية تحوي قيمة المعامل arg المعطى. أمثلة مثال على استخدام التابع String‎: String(self) #=> "main" String(self.class) #=> "Object" String(123456) #=> "123456" ‎ انظر أيضا التابع Array: يعيد المعامل المعطى على شكل مصفوفة (Array). التابع Integer: يحول ...

انظر صفحتي التابعين options و new. مصادر قسم الثابتة EXTENDED في الصنف Regexp‎ في توثيق روبي الرسمي.

يُنهِي التابع exit!‎ العملية على الفور. لا يتم تنفيذ أي معالجات إنهاء (exit handlers). وتعاد الحالة إلى النظام الأساسي (underlying system) كحالة الخروج (exit status). البنية العامة exit!(status=false)‎ المعاملات status‎ الحالة المراد إعادتها إلى النظام الأساسي كحالة الخروج (exit status). أمثلة مثال على استخدام التابع exit!‎: Process.exit!(true) انظر أيضا التابع exit: يبدأ التابع عملية إنهاء البرنامج النصي لروبي، عن طريق إطلاق استثناء SystemExit. التابع at_exit: يحول الكتلة البرمجية المعطاة إلى كائن من النوع Proc. مصادر قسم التابع exit!‎ في الصنف Kernel‎ في توثيق ...

ينفذ التابع spawn تعليمة محددة، ثم يعيد معرفها (pid). البنية العامة spawn([env,] command... [,options]) → pid spawn([env,] command... [,options]) → pid‎ يشبه التابعُ spawn التابعَ system باستثناء أنّه لا ينتظر إلى أن ينتهي تنفيذ الأمر. يجب على العملية الأب (parent process) أن تستخدم التابع Process.wait لتحصيل حالة الإنهاء للعملية الفرعية، أو تستخدم Process.detach لتسجيل عدم الاهتمام بحالتها؛ خلاف ذلك، قد يُراكم نظام التشغيل عمليات ميتة (zombie processes). التابع spawn لديه مجموعة من الخيارات لتحديد خاصيات العملية: env: hash name => ...

عند استدعاء التابع require_relative، ستحاول روبي تحميل المكتبة التي مُرِّر اسمها إليه نسبةً إلى مسار الملف المطلوب. إذا تعذر تحديد مسار الملف، سيُطلق الخطأ LoadError. إذا تم تحميل الملف، ستُعاد القيمة true، وإلا فستُعاد القيمة false. البنية العامة require_relative(string) → true or false‎ المعاملات string‎ سلسلة نصية تمثِّل اسم المكتبة المراد تحميلها. القيمة المعادة تُعاد القيمة true إذا تم تحميل المكتبة string، أو تعاد القيمة false خلاف ذلك. انظر أيضا التابع require: يُحمِّل ميزة محدَّدة ثمَّ يعيد true في حال نجح في ذلك، ...

في حال تعطيل التنبيهات (على سبيل المثال، عبر الراية ‎-W0) ، فإنّ التابع warn لن يفعل شيئًا. خلا ذلك، سيُحوّل كل الرسائل المُمرَّرة إليه إلى سلاسل نصية، ويضيف محرف سطر جديد إلى نهايتها إن لم تكن منتهيةً بسطر جديد، ثم يستدعي التابع Warning.warn، ويمرر إليه تلك السلسلة النصية. warn("warning 1", "warning 2") <em>produces:</em> warning 1 warning 2‎ البنية العامة warn(msg, ...)→ nil‎ المعاملات msg‎ الرسالة الممررة. ...‎ رسائل أخرى القيمة المعادة تعاد القيمة nil. انظر أيضا التابع raise: ...

ينقل التابع throw الضبط (control) إلى نهاية الكتلة catch المُترقبة للوسم المعطى (tag). إذا لم يكن هناك كتلة catch لذلك الوسم، فسيطلق الخطأ UncaughtThrowError. يوفر الوسيط الاختياري الثاني في حال تمريره قيمة لتُعيدها الكتلة catch، وإلا فستعيد nil. للحصول على بعض الأمثلة، انظر صفحة التابع catch. البنية العامة throw(tag [, obj])‎ المعاملات tag‎ الوسم الذي تترقبه الكتلة catch. obj‎ وسيط اختياري يوفر -في حال تمريره- قيمة لتُعيدها الكتلة catch. انظر أيضا التابع catch: ينفذ كتلته البرمجية. في حال عدم استدعاء throw، فستنفّذ ...

انظر صفحتي التابعين options و new. مصادر قسم الثابتة MULTILINE في الصنف Regexp‎ في توثيق روبي الرسمي.

يجعل التابع set_trace_func المعامل المعطى كمعالج للتعقب، أو يعطل التعقب إن كان الوسيط يساوي nil. ملاحظة: أصبح هذا التابع مهملًا، لذا يُرجى استخدام التابع TracePoint بدلاً منه. يقبل proc ستة معاملات هي: اسم حدث اسم ملف رقم سطر معرف كائن (object id) كائن ربط (binding) اسم صنف يستدعى proc كلما وقع حدث. الأحداث هي: الحدث الوصف c-call استدعاء برنامج فرعي في لغة C. c-return العودة من برنامج فرعي في لغة C. call استدعاء تابع من توابع روبي. class بدء تعريف ...

يكافي التابع proc التعبير Proc.new. البنية العامة proc{ |...| block } → a_proc‎ القيمة المعادة يعاد كائن جديد من النوع Proc. انظر أيضا انظر صفحة الصنف Proc. مصادر قسم التابع proc‎ في الصنف Kernel‎ في توثيق روبي الرسمي.

يعيد التابع local_variables مصفوفة تضم أسماء المتغيرات المحلية الحالية. البنية العامة local_variables → array‎ القيمة المعادة تعاد مصفوفة تضم أسماء المتغيرات المحلية الحالية. أمثلة مثال على استخدام التابع local_variables‎: fred = 1 for i in 1..10 # ... end local_variables #=> [:fred, :i]‎ انظر أيضا التابع global_variables: يعيد مصفوفةً تضم أسماء المتغيرات العامة (global variables). مصادر قسم التابع local_variables‎ في الصنف Kernel‎ في توثيق روبي الرسمي.

يكافئ التابع sub التعبير ‎‎‎$_‎.sub( args )‎ ، باستثناء أنه سيتم تحديث ‎$_‎ إذا حدث استبدال. متوفر فقط عند تحديد خيار سطر الأوامر ‎-p/-n. البنية العامة sub(pattern, replacement)→ $_ sub(pattern) {|...| block } → $_‎ القيمة المعادة يعاد ناتج استدعاء التعبير ‎‎‎$_‎.sub( args )‎. انظر أيضا التابع gsub: يكافئ التعبير ‎$_.gsub...‎، باستثناء أنه سيتم تحديث ‎$_‎ في حال حدوث استبدال. مصادر قسم التابع sub‎ في الصنف Kernel‎ في توثيق روبي الرسمي.

ينفذ التابع catch كتلته البرمجية. في حال عدم استدعاء throw، فستنفّذ الكتلة بشكل طبيعي، وسيعيد catch قيمة آخر تعبير تم تقييمه. catch(1) { 123 } # => 123 إذا استُدعي throw(tag2, val)‎، فستبحث روبي في المكدس (stack) عن كتلة التابع catch، التي يكون العنوان tag الخاص بها نفس القيمة object_id الخاص بالعنوان tag2. وعند العثور عليه، يتوقف تنفيذ الكتلة وتُعاد val (أو القيمة nil إذا لم يتم تمرير وسيط ثاني ...

يكافئ التابع lambda التعبير Proc.new، باستثناء أنّ الكائنات Proc الناتجة ستتحقق من عدد الوسائط الممررة عند استدعائها. البنية العامة lambda { |...| block } → a_proc‎ القيمة المعادة يعاد ناتج الاستدعاء Proc.new. انظر أيضا الصنف Proc. مصادر قسم التابع lambda‎ في الصنف Kernel‎ في توثيق روبي الرسمي.

ينهي التابع abort تنفيذ العملية على الفور عبر استدعاء Kernel.exit(false)‎. في حال تمرير رسالة إلى التابع، فستُكتَب في المجرى STDERR قبل الإنهاء. البنية العامة abort Kernel::abort([msg]) abort([msg])‎ المعاملات msg الرسالة التي ستُكتب في المجرى STDERR. انظر أيضا التابع at_exit: يحول الكتلة البرمجية المعطاة إلى كائن من النوع Proc ويسجله لأجل تنفيذه عند نهاية البرنامج. مصادر قسم التابع abort‎ في الصنف Kernel‎ في توثيق روبي الرسمي.

في حال استدعاء التابع fail بدون تمرير أي معامل، فسيُطلق الاستثناء في ‎$!‎‎‎‎ أو يطلق الخطأ RuntimeError إذا كان ‎$!‎ يساوي nil. في حال تمرير سلسلة نصية فقط، فسيُطلَق الخطأ RuntimeError مع إظهار هذه السلسلة النصية كرسالة. خلا ذلك، يجب أن يكون الوسيط الأول اسم الصنف Exception (أو كائنًا يعيد كائنًا من النوع Exception عند إرسال رسالة استثناء). يحدِّد الوسيط الاختياري الثاني الرسالة المرتبطة بالاستثناء، أما الوسيط الثالث فهو مصفوفة تضم معلومات الاستدعاء. تُلتقَط الاستثناءات بواسطة الجملة rescue من الكتل ...

يعيد التابع Complex ناتج التعبير x + i * y؛ حيث i هو الوحدة التخيلية للعدد العقدي. قواعد الصياغة النصية هي: string form = extra spaces , complex , extra spaces ; complex = real part | [ sign ] , imaginary part | real part , sign , imaginary part | rational , "@" , rational ; real part = rational ; imaginary part = imaginary unit | ...

استدعاء التابع raise بدون تمرير أي معامل يُطلق الاستثناء في ‎$!‎‎‎‎ أو يطلق الخطأ RuntimeError إذا كان ‎$!‎ يساوي nil. في حال تمرير سلسلة نصية فقط، فسيُطلَق الخطأRuntimeError مع إظهار هذه السلسلة النصية كرسالة. خلا ذلك، يجب أن يكون الوسيط الأول اسم الصنف Exception (أو كائنًا يعيد كائنًا من النوع Exception عند إرسال رسالة استثناء). يحدِّد الوسيط الاختياري الثاني الرسالة المرتبطة بالاستثناء، أما الوسيط الثالث فهو مصفوفة تضم معلومات الاستدعاء. تُلتقَط الاستثناءات بواسطة الجملة rescue من الكتل begin...end. البنية العامة raise raise(string) raise(exception [, string [, array]])‎ المعاملات string‎ سلسلة نصية تمثل الرسالة المراد إظهارها ...

محدد الخاصيات التي تساوي [name="value"‎]  الوصف تحديد العناصر التي تمتلك خاصيّة HTML المُحدَّدة والتي قيمتها تُساوي تمامًا قيمة مُعيَّنة. ‎jQuery( "[attribute='value']" )‎ أضيفت في الإصدار: 1.0. attribute اسم خاصيّة HTML. value قيمة خاصيّة HTML. يُمكِن أن تكون مُعرِّفًا صالحًا (valid identifier) أو سلسلةً نصيّةً موضوعةً بين علامتي اقتباس. أمثلة إيجاد كافّة حقول الإدخال التي تملك القيمة أحمر وتبديل نص عنصر <span> المُجاور لها: <!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>مثال عن محدد الخاصيات التي تساوي [name="value"‎]</title> <script src="https://code.jquery.com/jquery-1.10.2.js"></script> </head> <body> ...

يشبه التابع readline التابع gets باستثناء أنّه يطلق الخطأ EOFError عند الوصول إلى نهاية الملف. البنية العامة readline(sep=$/) → string readline(limit)→ string readline(sep, limit) → string‎ المعاملات sep‎ يمثل الحد الفاصل الذي ستتوقف عملية القراءة عنده وتعاد البيانات المقروءة. limit‎ الحد الأقصى للبيانات المراد قراءتها. القيمة المعادة يعيد البيانات المقروءة في سلسلة نصية حتى بداية كل سطر أو حتى الوصول إلى الفاصل sep. انظر أيضا التابع readlines: يعيد مصفوفة يحوي كل عنصر منها سطرًا من أسطر الملف المراد قراءته. مصادر قسم التابع ...

يحمّل التابع load وينفّذ برنامج روبي في الملف المعطى. في حال لم لميكن بالإمكان استبيان مسار الملف المطلق (absolute path)، فسيتم البحث عن الملف في مجلدات المكتبة الموجودة في ‎$:‎. إذا كان الوسيط الاختياري wrap يساوي true، فسيُنفذ النص البرمجي المحمّل كوحدة مجهولة (anonymous module)، لحماية مجال الأسماء الخاص بالبرنامج المُستدعَى. لن يتم نشر أيّ من المتغيرات المحلية الموجودة في الملف الذي تم تحميله تحت أي ظرف من الظروف في بيئة التحميل. البنية العامة load(filename, wrap=false)→ true‎ المعاملات filename‎ اسم ...

يجري التابع test عدة اختبارات على ملف واحد أو على ملفين. البنية العامة test(cmd, file1 [, file2] ) → obj‎ المعاملات cmd‎ يحدد الاختبار المراد تطبيقه. اختبارات File التي تطبَّق على ملف واحد هي: المعامل cmd نوع القيمة المعادة وصف "A" Time توقيت آخر دخول إلى الملف file1. "b" قيمة منطقية يعيد True إن كان الملف file1 جهازًا كتليًّا (block device). "c" قيمة منطقية يعيد True إن كان file1 من النوع جهازًا محرفيًّا (character device). "C" Time توقيت آخر تغيير ...

ينفذ التابع system الأمر المُمرَّر إليه في صدفة فرعية (subshell). البنية العامة system([env,] command... [,options]) → true, false or nil‎ المعاملات env‎ بيئة التنفيذ. يعد هذا المعامل الذي من النوع Hash مماثلة تمامًل لمعامل التابع exec و spawn. انظر صفحة spawn لمزيد من التفاصيل. command...‎ التعليمة المراد تنفيذها. تأخذ التعليمة command…‎ أحد الأشكال التالية. شكل المعامل command…‎ الوصف commandline تعليمة نصية تُمرر إلى الصدفة القياسية cmdname, arg1, ...‎ تعليمة نصية تُمرر إلى الصدفة القياسية ‎[cmdname, argv0], arg1, ...‎ تعليمة ووسيط ...

يتحقق التابع ‎between?‎ فيما إذا كان الكائن الذي استُدعي معه محصورًا بين الكائنين المٌمرّرين إليه. البنية العامة between?(min, max) → true or false المعاملات min يمثِّل هذا المعامل القيمة الدنيا للمجال المراد التحقق من وقوع القيمة المعطاة ضمنه. max  يمثِّل هذا المعامل القيمة القصوى للمجال المراد التحقق من وقوع القيمة المعطاة ضمنه. القيمة المعادة تُعاد القيمة false إن أعاد التعبير obj <=> min قيمةً أصغر من ‎‎0 أو إن أعاد التعبير obj <=> max قيمةً أكبر من 0؛ خلا ذلك، ستُعاد القيمة true. أمثلة أمثلة ...

يبدأ التابع exit عملية إنهاء البرنامج في روبي، عن طريق إطلاق استثناء SystemExit. من الممكن التقاط هذا الاستثناء. begin exit puts "never get here" rescue SystemExit puts "rescued a SystemExit exception" end puts "after begin block" ينتج عند تنفيذه: rescued a SystemExit exception after begin block‎ قبل الإنهاء مباشرة، تنفذ روبي كل التوابع والكتل المرتبطة بالشيفرة عبر التابع at_exit، وتنفِّذ كل الكائنات المُنهيَة (object finalizers، راجع ObjectSpace.define_finalizer). at_exit { puts "at_exit function" } ObjectSpace.define_finalizer("string", proc { puts "in finalizer" }) exit ينتج عند تنفيذ الشيفرة: ...

محدد الخاصيات التي فيها كلمة [name~="value"‎] الوصف تحديد العناصر التي تمتلك خاصيّة HTML المُحدَّدة والتي قيمتها تحتوي على الكلمة المُعطاة محدودةً بينها بمسافات فارغة. ‎jQuery( "[attribute~='value']" )‎ أضيفت في الإصدار: 1.0. attribute اسم خاصيّة HTML. value قيمة خاصيّة HTML. يُمكِن أن تكون مُعرِّفًا صالحًا (valid identifier) أو سلسلةً نصيّةً موضوعةً بين علامتي اقتباس. يُطابِق هذا المُحدِّد السلسلة النصيّة المُختَبَرَة مع كل كلمة من قيمة خاصيّة HTML، حيث تُعرَّف الكلمة كسلسلة نصيّة مفصولة بينها بمسافات فارغة. يُطابِق المُحدِّد إن كانت السلسلة ...