نتائج البحث

يعيد المعامل ‎=~‎ ناتج التعبير sym.to_s =~ obj. البنية العامة sym =~ obj→ integer or nil‎ القيمة المعادة يعاد ناتج التعبير sym.to_s =~ obj. انظر أيضًا المعامل ==: يتحقق من تساوي رمزين أي إن كان هذان الرمزان هما نفس الرمز. المعامل []: يعيد ناتج التعبير sym.to_s[]‎. مصادر قسم المعامل =~‎ في الصنف Symbol‎ في توثيق روبي الرسمي.

يوازن المعامل ‎‎‎==‎ بين كائنين بناءً على النتيجة التي يعيدها المعامل <=> الخاص بالمُستقبِل (receiver). البنية العامة obj == other → true or false القيمة المعادة تُعاد القيمة true إن أعاد المعامل <=> القيمة 0 (أي كان obj مساويًا للكائن other)؛ خلا ذلك، ستُعاد القيمة false. أمثلة أمثلة عن استخدام المعامل ==: i = 1; i == i ; #=> true "a" == "a" ; #=> true "a" == "A" ; #=> false 3 == 5 ; ...

يجلب المعامل [] قيمة عضو البنية المعطى، أو قيمة العضو ذي الفهرس المحدَّد. البنية العامة struct[member]→ object struct[index] → object‎ المعاملات member اسم العضو المراد جلب قيمته. index فهرس العضو المراد جلب قيمته. القيمة المعادة تعاد قيمة عضو البنية member المعطى، أو العضو ذو الفهرس index. يطلق الاستثناء NameError إن لم يكن member موجودًا، أو الاستثناء IndexError إن كان index خارج النطاق. أمثلة مثال على استخدام المعامل []‎: Customer = Struct.new(:name, :address, :zip) joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345) joe["name"] ...

يتحقق المعامل == من تطابق كائنان من النوع matchdata إذا كانت السلاسل النصية المستهدفة منهما، والأنماط ومواضع المُطابقة متماثلة. البنية العامة mtch == mtch2→ true or false‎ المعاملات mtch الطرف الأول في عملية الموازنة. mtch2 الطرف الثاني في عملية الموازنة. القيمة المعادة تعاد القيمة true إن كان الكائنان متساويان، وإلا فستُعاد القيمة false. انظر أيضا التابع eql?‎: يتحقق من تساوي كائنين من النوع matchdata. مصادر قسم المعامل ==‎ في الصنف MatchData‎ في توثيق روبي الرسمي.

يعيد المعامل =< القيمة 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 إذا كان ...

يتحقق المعامل == من تساوي كائنين من النوع Method. يكون كائنان من النوع Method متساويين إن كانا مرتبطين بنفس الكائن، وكانا لهما نفس التعريف، وكان لهما نفس الصنف أو الوحدة (module) المالكة. البنية العامة meth == other_meth → true or false‎ القيمة المعادة تُعاد القيمة true إن كان الكائنان متساويين، وإلا فستُعاد القيمة false. انظر أيضا التابع ===: يستدعي كتلة التابع مع تمرير الكائن الواقع على يمينه كوسيط إلى المعامل الواقع على يساره كما هو الحال في Proc.call. مصادر قسم ...

يوازن المعامل ‎‎‎<=‎ بين كائنين بناءً على النتيجة التي يعيدها المعامل <=> الخاص بالمُستقبِل (receiver). البنية العامة obj <= other → true or false القيمة المعادة تُعاد القيمة true إن أعاد المعامل <=> القيمة ‎-1‎ أو 0 (أي كان obj أًصغر من أو يساوي الكائن other)، وإلا فسيعيد false. أمثلة أمثلة عن استخدام المعامل =>: "a" <= "a" ; #=> true "a" <= "A" ; #=> false 3 <= 5 ; #=> true انظر أيضًا المعامل ...

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

يعيد المعامل %‎ باقي عملية قسمة عدد عشري على عدد آخر. البنية العامة float % other → float المعاملات float عدد عشري يمثل الطرف الأول في عملية القسمة. other عدد آخر يمثل الطرف الثاني في عملية القسمة. القيمة المعادة يعاد باقي عملية القسمة للعدد float على العدد other. أمثلة مثال على استخدام المعامل %‎: 6543.21.modulo(137) #=> 104.21000000000004 6543.21.modulo(137.24) #=> 92.92999999999961 انظر أيضا المعامل *: يعيد ناتج عملية الضرب بين عددين. مصادر قسم المعامل %‎ في ...

يتحقق المعامل == من تساوي رمزين أي إن كان هذان الرمزان هما نفس الرمز. البنية العامة sym == obj→ true or false‎ القيمة المعادة تعاد القيمة true إن كان sym و obj نفس الرمز. خلا ذلك، تعاد القيمة false. انظر أيضًا المعامل <=>: يقارن بين رمزين ثم يعيد ‎-1 أو 0 أو ‎+1 بناءً على ما إذا كان الرمز الأول أصغر من أو يساوي أو أكبر من الرمز الثاني. المعامل ===: يتحقق إن كان رمزان هما نفس الرمز. مصادر قسم المعامل ==‎ في الصنف ...

يوازن المعامل <=> بين عدد جذري وعدد آخر ثم يعيد القيم 1- أو 0 أو 1 بناءً على ما إن كان العدد الجذري الواع على يساره أصغر من أو يساوي أو أكبر من العدد الآخر. ستُعاد القيمة nil إن كانت القيمتان غير قابلتين للموازنة. البنية العامة rational <=> numeric → -1, 0, +1, or nil‎ القيمة المعادة تعاد القيم 1- أو 0 أو 1 بناءً على ما إن كان rationalأصغر من أو يساوي أو أكبر من numeric. تعاد القيمة ...

يعيد المعامل > القيمة true إن كانت قيمة العدد العشري الواقع على يساره أصغر من قيمة العدد المواقع على يمينه. البنية العامة float < real → true or false‎ القيمة المعادة تعاد القيمة true إن كانت قيمة float أصغر من قيمة real. ملاحظة: نتيجة NaN < NaN غير مُعرَّفة، لذا تُعاد قيمة تعتمد على التنفيذ. أمثلة مثال على استخدام المعامل >: 20.0 < 3 #=> false 20.0 < 30 #=> 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 إذا ...

يتحقق المعامل == من تساوي مصفوفتين مع بعضهما بعضًا. تكون مصفوفتان متساويتين إن حوت كلاهما نفس عدد العناصر، وكان كل عنصر من المصفوفة الأولى مساويًا لنظيره في المصفوفة الثانية. البنية العامة ary == other_ary → bool القيم المعادة تُعاد القيمة true المنطقية إن كانت المصفوفتان متساويتين، أو القيمة false خلاف ذلك. أمثلة أمثلة عن استخدام المعامل ==: [ "a", "c" ] == [ "a", "c", 7 ] #=> false [ "a", "c", ...

يعيد المعامل + ناتج عملية الجمع بين عددين. نوع الكائن المعاد يتعلق بنوع الطرف الثاني للعملية.  البنية العامة int + numeric → numeric_result‎ المعاملات int عدد صحيح يمثل الطرف الأول في للعملية. numeric  عدد يمثل الطرف الثاني للعملية. القيمة المعادة يعاد ناتج عملية الجمع بين العددين int و numeric. صنف الكائن الناتج يتعلق بصنف الطرف الثاني للعملية.  أمثلة مثال على استخدام المعامل +‎: 20 + 3 #=> 23 6 + 0 ...

يعيد المعامل + عند استدعائه بالشكل str+ نسخةً مطابقةً للسلسلة النصية str وقابلةً للتغيير (Mutable) في حال كانت هذه السلسلة النصية مجمدة. أما إذا كانت السلسلة النصية غير مجمدة، فسيعيد المعامل السلسلة النصية نفسها. البنية العامة +str → str (mutable) c القيمة المعادة تعاد نسخة مطابقة وقابلة للتغيير (Mutable) من السلسلة النصية str المعطاة إن كانت هذه السلسلة مجمَّدة؛ أما إن لم تكن مجمدة، فستُعاد السلسلة النصية نفسها. أمثلة مثال على استعمال المعامل +: n1= “Hello ” n1.freeze n2 = +n1 n2<<”World” puts n2 المثال ...

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

الخاصية border-top-right-radius في CSS تضبط تدوير الركن العلوي الأيمن من العنصر. بطاقة الخاصية القيمة الابتدائية 0 تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك نعم النسب المئوية نسبة من البُعد الموافق للقيمة من إطار العنصر. القيمة المحسوبة قيمتان للطول <length>، أو نسبتان مئويتان <percentage>. /* الركن سيكون دائريًا */ /* border-top-right-radius: radius */ border-top-right-radius: 3px; /* نسب مئوية */ border-top-right-radius: 20%; /* الركن سيكون دائريًا إن كان العنصر مربعًا */ border-top-right-radius: 20% 20%; /* كما في القاعدة السابقة، أي 20% من العرض و 20% ...

يتحقق المعامل === من تساوي السلسلة النصية مع أي كائن آخر، علمًا أن المساواة تتحقق عند تطابق الطول والمحتوى. إذا لم يكن الكائن من نوع سلسلة نصية، فيمكن استعمال الدالة to_s لتحويله إلى سلسلة نصية إذا أمكن ذلك. البنية العامة str === obj → true or false المعاملات str السلسلة النصية وتمثل الطرف الأول من عملية التحقق. obj الكائن المُراد التحقق من مساواته مع السلسلة النصية str. القيمة المعادة تُعاد القيمة true إذا كانت السلسلة النصية str مساويةً للكائن obj ...

يرفع المعامل ‎** عددًا عقديًّا إلى قوة عددٍ محدَّدٍ. البنية العامة cmp ** numeric → complex المعاملات cmp العدد العقدي الذي يمثِّل الأساس. numeric القيمة العددية التي تمثِّل القوة. القيمة المعادة يعاد عددٌ عقديٌ ناتج عن رفع العدد cmp العقدي إلى القوة numeric (أي ناتج cmpnumeric). أمثلة أمثلة عن استخدام المعامل **: Complex('i') ** 2 #=> (-1+0i) Complex(-8) ** Rational(1, 3) #=> (1.0000000000000002+1.7320508075688772i) انظر أيضًا المعامل *‎: يجري عملية ...

يجري المعامل <=> عملية الموازنة بين كائنين ثم يعيد الناتج الذي يشير إلى العلاقة بينهما. البنية العامة 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: ...