نتائج البحث

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