نتائج البحث

المصفوفة في PHP هي خريطة (map) مرتّبة، والخريطة هي نوع ترتبط فيه القيم مع المفاتيح، ولها استخدامات عديدة، فيمكن التعامل معها كمصفوفة أو قائمة (vector) أو جدول hash (نوع من الخرائط) أو قاموس (dictionary) أو مجموعة (collection) أو مكدس (stack) أو طابور (queue) وغير ذلك، حتى أن قيم المصفوفة يمكن أن تكون مصفوفات أخرى، ممّا يسمح بإنشاء مصفوفات متعددة الأبعاد. لن نشرح جميع هذه الأنواع في هذا التوثيق، لكن ستجد مثالًا واحدًا على الأقل لكلٍ منها. الصياغة إنشاء المصفوفات باستخدام ...

المصفوفة هي مجموعة من المتغيرات الموضوعة في وعاء واحد والتي يمكن الوصول إليها عبر رقم فهرس كلٍّ منها. يمكن أن تكون المصفوفات في لغة C، التي ترتكز عليها لغة أردونيو، معقدةً بعض الشيء ولكنَّ استعمال المصفوفات بأبسط شكل لها هو أمر سهل ويسير. إنشاء مصفوفة يوجد عدة طرائق لإنشاء مصفوفة منها: int myInts[6]; int myPins[] = {2, 4, 8, 3, 6}; int mySensVals[6] = {2, 4, -8, 3, 2}; char message[6] = "hello"; يمكنك التصريح عن مصفوفة دون تهيئتها ووضع قيم فيها كما في ...

المصفوفة في PHP هي خريطة (map) مرتّبة، والخريطة هي نوع ترتبط فيه القيم مع المفاتيح، ولها استخدامات عديدة، فيمكن التعامل معها كمصفوفة أو قائمة (vector) أو جدول hash (نوع من الخرائط) أو قاموس (dictionary) أو مجموعة (collection) أو مكدس (stack) أو طابور (queue) وغير ذلك، حتى أن قيم المصفوفة يمكن أن تكون مصفوفات أخرى، ممّا يسمح بإنشاء مصفوفات متعددة الأبعاد. لن نشرح جميع هذه الأنواع في هذا التوثيق، لكن ستجد مثالًا واحدًا على الأقل لكلٍ منها. الصياغة إنشاء المصفوفات باستخدام ...

تسمح لك هذه الدوال بالتعامل مع المصفوفات وتعديلها بطرائق عديدة. المصفوفات عنصر أساسي لتخزين وإدارة والتعامل مع مجموعاتٍ من المتغيرات. تدعم لغة PHP المصفوفات أحادية ومتعددة الأبعاد، ويمكن أن ينتجها المستخدم بنفسه أو أن يستخدم دوالًا أخرى لإنشائها. توجد كذلك دوال متخصصة للتعامل مع قواعد البيانات وملأ المصفوفات من نواتج استعلامات قواعد البيانات، وتعيد الكثير من الدوال مصفوفاتٍ أيضًا. رجاءً تصفَّح نوع البيانات الخاص بالمصفوفات من هذا التوثيق للحصول على شرح تفصيلي عن كيفية استعمال المصفوفات في لغة PHP. انظر ...

إنشاء المصفوفات المصفوفة هي متغير يحتوي قيمًا متعددة، وأي متغير قد يُستخدم كمصفوفة، كذلك لا يوجد حد أقصى لحجم المصفوفة ولا يُشترط أن تُفهرس المتغيرات داخل المصفوفة أو تُعيَّن في وقت واحد، وقد تكون المصفوفات صفرية القاعدة أي يُفهرس أول عنصر برقم صفر. ينفَّذ التصريح غير المباشر عن المتغير (indirect declaration) باستخدام البنية اللغوية التالية: ARRAY[INDEXNR]=value يعامَل المفهرِس INDEXER على أنه تعبير حسابي يجب أن يٌقدَّر بعدد موجب، ويتم التصريح الواضح (explicit declaration) للمصفوفة باستخدام أمر declare: declare -a ARRAYNAME يُقبَل التصريح ...

المثال الاسم النتيجة ‎$a + $b الاندماج اندماج ‎$a و ‎$b. ‎$a == $b المساواة TRUE إن كان ‎$a و ‎$b يمتلكان نفس أزواج مفتاح/قيمة. ‎$a === $b التطابق TRUE إن كان ‎$a و ‎$b يمتلكان نفس أزواج مفتاح/قيمة وبنفس الترتيب ومن نفس النوع. ‎$a != $b عدم المساواة TRUE إن كان ‎$a و ‎$b غير متساويين. ‎$a <> $b عدم المساواة TRUE إن كان ‎$a و ‎$b غير متساويين. ‎$a !== $b عدم التطابق TRUE إن كان ‎$a و ‎$b غير ...

مصفوفات البايتات bytearray هي الكائنات القابلة للتغيير والتي تقابل كائنات البايتات bytes. يُعيد الصّنف bytearray()‎ (والذي يُعامَل مُعاملة الدّالة) مصفوفة بايتات جديدة، ويكون الصّنف تسلسُلًا قابلًا للتّغيير يحتوي على الأعداد الصّحيحة ضمن المدى ‎0 <= x < 256. ويملك مُعظم التّوابع التي تملكها التّسلسلات الأخرى (كالقوائم والصّفوف مثلًا)، والمشروحة في صفحة أنواع التسلسلات القابلة للتّغيير، إضافةً إلى امتلاك مُعظم التّوابع التي يملكها النّوع bytes. البنية العامة bytearray([source[, encoding[, errors]]]) المعاملات source مُعامل اختياريّ يُستعمل لتهيئة المصفوفة عبر عدّة طُرق مختلفة: ...

تحتوي لغة PHP على الكثير من الدوال التي تتعامل مع ترتيب المصفوفات، وهذه الصفحة تساعد على التفريق بينها. الاختلافات الرئيسية هي: ترتب بعض الدوال المصفوفات بناءً على مفاتيحها (keys)، بينما ترتبها دوالٌ أخرى بناءً على القيم المرتبطة مع كل مفتاح. قد تحافظ بعض الدوال على العلاقة ما بين المفتاح والقيمة المسجلة معه بعد عملية الترتيب. لكن هذا قد يعني أنه في بعض الأحيان سيُعاد ضبط المفاتيح إلى الوضعية الافتراضية العددية (0، 1، 2 …). طريقة الترتيب: هجائيًا من الأصغر إلى ...

المثال الاسم النتيجة ‎$a + $b الاندماج اندماج ‎$a و ‎$b. ‎$a == $b المساواة TRUE إن كان ‎$a و ‎$b يمتلكان نفس أزواج مفتاح/قيمة. ‎$a === $b التطابق TRUE إن كان ‎$a و ‎$b يمتلكان نفس أزواج مفتاح/قيمة وبنفس الترتيب ومن نفس النوع. ‎$a != $b عدم المساواة TRUE إن كان ‎$a و ‎$b غير متساويين. ‎$a <> $b عدم المساواة TRUE إن كان ‎$a و ‎$b غير متساويين. ‎$a !== $b عدم التطابق TRUE إن كان ‎$a و ‎$b غير ...

تحتوي لغة PHP على الكثير من الدوال التي تتعامل مع ترتيب المصفوفات، وهذه الصفحة تساعد على التفريق بينها. الاختلافات الرئيسية هي: ترتب بعض الدوال المصفوفات بناءً على مفاتيحها (keys)، بينما ترتبها دوالٌ أخرى بناءً على القيم المرتبطة مع كل مفتاح. قد تحافظ بعض الدوال على العلاقة ما بين المفتاح والقيمة المسجلة معه بعد عملية الترتيب. لكن هذا قد يعني أنه في بعض الأحيان سيُعاد ضبط المفاتيح إلى الوضعية الافتراضية العددية (0، 1، 2 …). طريقة الترتيب: هجائيًا من الأصغر إلى ...

تقنية إعادة التصميم هذه هي حالة خاصة من تبديل قيم البيانات إلى كائنات. المشكلة لديك مصفوفة تحتوي على أنواع مختلفة من البيانات. الحل استبدال المصفوفة بكائن يكون له حقول منفصلة لكل عنصر. مثال قبل إعادة التصميم احتواء المصفوفة row على نوعين مختلفين من البيانات (سلسلة نصية وعدد): في لغة Java: String[] row = new String[2]; row[0] = "Liverpool"; row[1] = "15"; في لغة C#‎: string[] row = new string[2]; row[0] = "Liverpool"; row[1] = "15"; في لغة PHP: $row = array(); $row[0] = "Liverpool"; $row[1] = 15; في لغة ...

تدعم كائنات البايتات ومصفوفات البايتات عمليات التسلسلات الشائعة، وتتوافق هذه الكائنات مع العوامل من النوع ذاته إضافة إلى أي كائن شبيه بالبايتات. ونظرًا لهذه المرونة العالية، يمكن استخدام البايتات في أي نوع من العمليات دون حدوث أي خطأ، ولكن النوع المعاد يعتمد على ترتيب العوامل. ملاحظة: لا يمكن تمرير سلاسل نصية كوسائط في التوابع التي تعمل على البايتات ومصفوفات البايتات كما لا يمكن تمرير البايتات في توابع السلاسل النصية. فعلى سبيل المثال يجب كتابة: a = "abc" b = a.replace("a", "f") و: ...

تدعم كائنات البايتات ومصفوفات البايتات عمليات التسلسلات الشائعة، وتتوافق هذه الكائنات مع العوامل من النوع ذاته إضافة إلى أي كائن شبيه بالبايتات. ونظرًا لهذه المرونة العالية، يمكن استخدام البايتات في أي نوع من العمليات دون حدوث أي خطأ، ولكن النوع المعاد يعتمد على ترتيب العوامل. ملاحظة: لا يمكن تمرير سلاسل نصية كوسائط في التوابع التي تعمل على البايتات ومصفوفات البايتات كما لا يمكن تمرير البايتات في توابع السلاسل النصية. فعلى سبيل المثال يجب كتابة: a = "abc" b = a.replace("a", "f") و: ...

تعرف هذه الوحدة كائنًا يمكن عن طريقه تمثيل مصفوفة من القيم الأساسية مثل الحروف والأعداد الصحيحة والأعداد ذات الفاصلة العائمة بشكل مضغوط. تعد المصفوفات نوعًا من أنواع التسلسلات وتشبه القوائم في عملها على نحو كبير، باستثناء أن أنواع الكائنات التي يمكن تخزينها في المصفوفات محدودة. أنواع الكائنات التي يمكن تخزينها في المصفوفات يجب تحديد نوع الكائنات عند إنشاء المصفوفة وذلك باستخدام رمز النوع وهو عبارة عن حرف واحد فقط. يبين الجدول التالي رموز الأنواع المتاحة: رمز النوع النوع في لغة ...

الكائن Array يُستخدَم في إنشاء المصفوفات، والتي هي قوائم شبيهة بالكائنات. إنشاء مصفوفة var fruits = ['Apple', 'Banana']; console.log(fruits.length); // 2 الوصول إلى عنصر من عناصر المصفوفة var first = fruits[0]; // Apple var last = fruits[fruits.length - 1]; // Banana المرور على عناصر المصفوفة بحلقة تكرار fruits.forEach(function(item, index, array) { console.log(item, index); }); // Apple 0 // Banana 1 إضافة عنصر في نهاية المصفوفة var newLength = fruits.push('Orange'); // ["Apple", "Banana", "Orange"] إزالة عنصر من نهاية المصفوفة var last = fruits.pop(); // إزالة Orange (من النهاية) // ["Apple", ...

اختبار

(PHP 4, PHP 5, PHP 7) تنشئ الدالة array()‎ مصفوفة جديدة. الوصف array array ([ mixed $... ] ) تنشئ هذه الدالة مصفوفة جديدة. للمزيد من المعلومات حول ماهية المصفوفة اقرأ عن النوع array. المعاملات ... يُعرَّف التركيب "الفهرس => القيم" كلًا من الفهرس والقيمة المقابلة وتفصل الفاصلة , بين تلك الأزواج. قد يكون الفهرس من نوع السلاسل النصية أو الأعداد الصحيحة. إذا حُذِفَ الفهرس فسيتولّد فهرس من نوع الأعداد الصحيحة تلقائيًا بدءًا من 0. وإذا كان الفهرس عددًا صحيحًا، فسيكون ...

المصفوفات هي مجموعات مُرتَّبة ومُفهرسة بالأعداد الصحيحة (integer-indexed) ومُكونة من أي نوع من الكائنات. تبدأ فهارس المصفوفات بالعدد 0، كما هو الحال في لغتي C و Java. ويفترض أن يُحسب الفهرس السالب بدءًا من نهاية المصفوفة، أي أنَّ الفهرس ذا القيمة ‎-1 يشير إلى العنصر الأخير في المصفوفة، والفهرس ‎-2 يمثل موضع العنصر ما قبل الأخير، وهلم جرًا. إنشاء المصفوفات يمكن إنشاء مصفوفة جديدة باستخدام المعامل [] الباني. يمكن أن تحتوي المصفوفة نفسها على أنواع مختلفة من الكائنات. على سبيل ...

ينشئ التابع Array.[]‎ مصفوفةً جديدةً تحوي الكائنات المُمرّرة إليها. القيم المعادة تعاد مصفوفة جديدة تحوي الكائنات المعطاة. أمثلة مثالٌ يوضح عدة طرائق لاستعمال الدالة Array.[]‎ في إنشاء مصفوفة: Array.[]( 1, 'a', /^A/ ) # => [1, "a", /^A/] Array[ 1, 'a', /^A/ ]    # => [1, "a", /^A/] [ 1, 'a', /^A/ ]         # => [1, "a", /^A/] انظر أيضًا الدالة new()‎: تنشئ مصفوفةً جديدةً. مصادر قسم التابع Array.[]‎ في الصنف Array في توثيق روبي الرسمي.

ينشئ التابع Array.[]‎ مصفوفةً جديدةً تحوي الكائنات المُمرّرة إليها. القيم المعادة تعاد مصفوفة جديدة تحوي الكائنات المعطاة. أمثلة مثالٌ يوضح عدة طرائق لاستعمال الدالة Array.[]‎ في إنشاء مصفوفة: Array.[]( 1, 'a', /^A/ ) # => [1, "a", /^A/] Array[ 1, 'a', /^A/ ]    # => [1, "a", /^A/] [ 1, 'a', /^A/ ]         # => [1, "a", /^A/] انظر أيضًا التابع new()‎: ينشئ مصفوفةً جديدةً. مصادر قسم التابع []‎ في الصنف Array في توثيق روبي الرسمي.

يعيد المعامل - مصفوفة جديدة تمثل نسخة من جميع عناصر المصفوفة الأصلية باستثناء العناصر المشتركة مع المصفوفة الأخرى. تحافظ المصفوفة المعادة على نفس ترتيب العناصر في المصفوفة الأصلية. يوازن المعامل - العناصر باستخدام التابعين ()hash و ()eql?‎ للحصول على أعلى كفاءة. البنية العامة ary - other_ary → new_ary القيم المعادة تعاد مصفوفة جديدة تمثل نسخة من جميع عناصر المصفوفة الأصلية باستثناء العناصر المشتركة مع المصفوفة other_ary الأخرى. أمثلة مثالٌ عن استعمال المعامل -: [ 1, 1, 2, 2, 3, 3, ...

يجمع المعامل + مصفوفتين معًا في مصفوفة واحدة جديدة. البنية العامة ary + other_ary → new_ary القيم المعادة تعاد مصفوفة جديدة تضم المصفوفة ary والمصفوفة other_ary معًا. أمثلة مثالٌ عن استخدام المعامل +: [ 1, 2, 3 ] + [ 4, 5 ] #=> [ 1, 2, 3, 4, 5 ] a = [ "a", "b", "c" ] c = a + [ "d", "e", "f" ] c ...

يعيد معامل الموازنة <=> عددً‎ا صحيحًا (‎-1 أو 0 أو ‎+1) إذا كانت المصفوفة الأصلية أصغر من أو تساوي أو أكبر من المصفوفة الأخرى المعطاة على التوالي. يوازن كل كائن من كل مصفوفة باستخدام المعامل <=>. يوازن بين المصفوفات عنصرًا عنصرًا؛ بعبارة أخرى، يوازن العنصر الأول من المصفوفة الأولى مع العنصر الأول من المصفوفة الثانية باستخدام المعامل <=>، ثم يوازن العنصر الثاني فالثالث وهكذا دواليك. متى ما أعطيت نتيجة مغايرة للصفر لأيٍّ من تلك الموازنات التي تجرى على العناصر تباعًا ...

يعيد المعامل & مصفوفةً جديدةً تحتوي على العناصر المشتركة بين مصفوفتين دون تكرارها. تحافظ المصفوفة المعادة على نفس ترتيب العناصر في المصفوفة الأصلية. توازن العناصر باستخدام التابعين ()hash و ()eql?‎ للحصول على أعلى كفاءة. البنية العامة ary & other_ary → new_ary القيم المعادة تعاد مصفوفة جديدة تحتوي على العناصر المشتركة بين المصفوفة ary والمصفوفة other_ary دون تكرارها. أمثلة مثالٌ عن استخدام المعامل &: [ 1, 1, 3, 5 ] & [ 3, 2, 1 ] ...

إن استعمل المعامل * مع مصفوفة وسلسلة نصية، فسيُكافئ حينئذٍ العبارة ary.join(str)‎. أمَّا إن استعمل مع مصفوفة وعدد، فسيُعيد مصفوفة جديدة تتكرر فيها المصفوفة تلك عددًا من المرات مساويًا لذلك العدد المعطى. البنية العامة ary * int → new_ary ary * str → new_string القيم المعادة تعاد مصفوفة أو سلسلة نصية جديدة. أمثلة مثالٌ عن استخدام المعامل * مرةً مع عدد وأخرى مع سلسلة نصية: [ 1, 2, 3 ] * 3 #=> [ 1, 2, ...

يضيف المعامل >> كائنًا مُحدَّدًا إلى نهاية المصفوفة الأصلية ثم يعيد المصفوفة نفسها، لذا يمكن تكرار هذا المعامل عدة مرات وبشكل متسلسل. البنية العامة ary << obj → ary القيم المعادة تعاد المصفوفة نفسها المعطاة بعد إضافة الكائن obj إليها. أمثلة أمثلة عن استخدام المعامل >>: a = [ 1, 2 ] a << "c" << "d" << [ 3, 4 ] #=> [ 1, 2, "c", "d", [ 3, 4 ] ...

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

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

يجلب المعامل [] عنصرًا ذي فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من مصفوفة. إن مُرِّرت قيم سالبة للفهارس، فسيُحسَب موضع العنصر بدءًا من نهاية المصفوفة، إذ تمثل القيمة ‎-1 فهرس العنصر الأخير. بالنسبة للوسيطين start و range، يكون فهرس البداية قبل العنصر. إضافةً إلى ذلك، ستُعاد مصفوفة فارغة في حال كان فهرس بداية المجال المحدد يقع عند نهاية المصفوفة. البنية العامة ary[index] → obj or nil ary[start, length] → new_ary or nil ary[range] → new_ary ...

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

تحول الدالة toCharArray()‎ المصفوفة العامة (أي التي من النوع Array<Char>‎) أو المجموعة التي استُدعيت معها إلى مصفوفة من النوع CharArray. البنية العامة fun Array<out Char>.toCharArray(): CharArray fun Collection<Char>.toCharArray(): CharArray القيمة المعادة تعاد مصفوفة من النوع CharArray تحوي جميع عناصر المصفوفة العامة (أي التي من النوع Array<Char>‎) أو المجموعة المعطاة. أمثلة استعمال الدالة ()toCharArray لتحويل مصفوفة من النوع Array<Char>‎ إلى مصفوفة من النوع CharArray: import java.util.Arrays fun main(args: Array<String>) { val array: Array<Char> = arrayOf('a', 'b', 'c') println(array.toCharArray().javaClass.kotlin.qualifiedName) // kotlin.CharArray } انظر أيضًا الدالة toBooleanArray()‎: تحول المصفوفة العامة (أي من النوع Array<out Boolean>‎) أو المجموعة  التي استُدعيت معها ...

تحول الدالة toShortArray()‎ المصفوفة العامة (أي من النوع Array<Short>‎) أو المجموعة التي استُدعيت معها إلى مصفوفة من النوع ShortArray. البنية العامة fun Array<out Short>.toShortArray(): ShortArray fun Collection<Short>.toShortArray(): ShortArray القيمة المعادة تعاد مصفوفة من النوع ShortArray تحوي جميع عناصر المصفوفة العامة (أي من النوع Array<Short>‎) أو المجموعة المعطاة. أمثلة استعمال الدالة ()toShortArray لتحويل مصفوفة من النوع Array<Short>‎ إلى مصفوفة من النوع ShortArray: import java.util.Arrays fun main(args: Array<String>) { val array: Array<Short> = arrayOf(4, 5, 6) println(Arrays.toString(array.toShortArray())) // [4, 5, ...

تحول الدالة toDoubleArray()‎ المصفوفة العامة (أي من النوع Array<Double>‎) أو المجموعة التي استُدعيت معها إلى مصفوفة من النوع DoubleArray. البنية العامة fun Array<out Double>.toDoubleArray(): DoubleArray fun Collection<Double>.toDoubleArray(): DoubleArray القيمة المعادة تعاد مصفوفة من النوع DoubleArray تحوي جميع عناصر المصفوفة العامة (أي من النوع Array<Double>‎) أو المجموعة المعطاة. أمثلة استعمال الدالة ()toDoubleArray لتحويل مصفوفة من النوع Array<Double>‎ إلى النوع DoubleArray: import java.util.Arrays fun main(args: Array<String>) { val array: Array<Double> = arrayOf(4.5, 5.4, 6.0) println(Arrays.toString(array.toDoubleArray())) // [4.5, 5.4, 6.0] ...

تحول الدالة toBooleanArray()‎ المصفوفة العامة (أي من النوع Array<out Boolean>‎) أو المجموعة التي استُدعيت معها إلى مصفوفة من قيم منطقية (أي من النوع BooleanArray) . البنية العامة fun Array<out Boolean>.toBooleanArray(): BooleanArray fun Collection<Boolean>.toBooleanArray(): BooleanArray القيمة المعادة تعاد مصفوفة من القيم المنطقية (من النوع BooleanArray) تحوي جميع عناصر المصفوفة العامة (من النوع Array<out Boolean>‎) أو المجموعة المعطاة. أمثلة استعمال الدالة ()toBooleanArray لتحويل مصفوفة من النوع Array<Boolean>‎ إلى النوع BooleanArray: import java.util.Arrays fun main(args: Array<String>) { val array: Array<Boolean> = arrayOf(true, true, false) ...

تحول الدالة toFloatArray()‎ المصفوفة العامة (أي من النوع Array<Float>‎) أو المجموعة  التي استُدعيت معها مصفوفة من النوع FloatArray. البنية العامة fun Array<out Float>.toFloatArray(): FloatArray fun Collection<Float>.toFloatArray(): FloatArray القيمة المعادة تعاد مصفوفة من النوع FloatArray تحوي جميع عناصر المصفوفة العامة (أي من النوع Array<Float>‎) أو المجموعة المعطاة. أمثلة استعمال الدالة ()toFloatArray لتحويل مصفوفة من النوع Array<Float>‎ إلى النوع FloatArray: import java.util.Arrays fun main(args: Array<String>) { val array: Array<Float> = arrayOf(4.5f, 5.4f, 6.0f) println(Arrays.toString(array.toFloatArray())) // [4.5, 5.4, 6.0] ...

تحوِّل الدالة toByteArray()‎ المصفوفة العامة (أي من النوع Array<Byte>‎) أو المجموعة التي استُدعيت معها إلى مصفوفة من النوع ByteArray. البنية العامة fun Array<out Byte>.toByteArray(): ByteArray fun Collection<Byte>.toByteArray(): ByteArray القيمة المعادة تعاد مصفوفة من النوع ByteArray تحوي جميع عناصر المصفوفة العامة (أي من النوع Array<Byte>‎) أو المجموعة المعطاة. أمثلة استعمال الدالة ()toByteArray لتحويل مصفوفة من النوع Array<Byte>‎ إلى النوع ByteArray: import java.util.Arrays fun main(args: Array<String>) { val array: Array<Byte> = arrayOf(1, 5, 6) println(array.toByteArray().javaClass.kotlin.qualifiedName) // kotlin.ByteArray } انظر أيضًا لدالة toBooleanArray()‎: تحول المصفوفة العامة (أي من النوع Array<out Boolean>‎) أو المجموعة  التي استُدعيت معها إلى مصفوفة من القيم ...

تحول الدالة toLongArray()‎ المصفوفة العامة (أي من النوع Array<Long>‎) أو المجموعة التي استُدعيت معها إلى مصفوفة من النوع LongArray. البنية العامة fun Array<out Long>.toLongArray(): LongArray fun Collection<Long>.toLongArray(): LongArray القيمة المعادة تعاد مصفوفة من النوع LongArray تحوي جميع عناصر المصفوفة العامة (أي من النوع Array<Long>‎) أو المجموعة المعطاة. أمثلة استعمال الدالة ()toLongArray لتحويل مصفوفة من النوع Array<Long>‎ إلى النوع LongArray: import java.util.Arrays fun main(args: Array<String>) { val array: Array<Long> = arrayOf(4, 5, 6) println(Arrays.toString(array.toLongArray())) // [4, 5, 6] ...

تحول الدالة toIntArray()‎ المصفوفة العامة (أي من النوع Array<Int>‎) أو المجموعة التي استُدعيت معها إلى مصفوفة من النوع IntArray. البنية العامة fun Array<out Int>.toIntArray(): IntArray fun Collection<Int>.toIntArray(): IntArray القيمة المعادة تعاد مصفوفة من النوع IntArray تحوي جميع عناصر المصفوفة العامة (أي من النوع Array<Int>‎) أو المجموعة المعطاة. أمثلة استعمال الدالة ()toIntArray لتحويل مصفوفة من النوع Array<Int>‎ إلى النوع IntArray: import java.util.Arrays fun main(args: Array<String>) { val array: Array<Int> = arrayOf(4, 5, 6) println(Arrays.toString(array.toIntArray())) // [4, 5, 6] ...

تضيف الدالة toCollection()‎ جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها إلى المجموعة المتغيرة (MutableCollection) المُمرّرة إليها. البنية العامة fun <T, C : MutableCollection<in T>> Array<out T>.toCollection( destination: C ): C fun <C : MutableCollection<in Byte>> ByteArray.toCollection( destination: C ): C fun <C : MutableCollection<in Short>> ShortArray.toCollection( destination: C ): C fun <C : MutableCollection<in Int>> IntArray.toCollection( destination: C ): C fun <C : MutableCollection<in Long>> LongArray.toCollection( destination: C ): ...

تحول الدالة toMutableList()‎ المصفوف أو المجموعة التي استُدعيت معها إلى قائمة متغيرة. البنية العامة يمكن استدعاء الدالة toMutableList()‎ مع المصفوفات: fun <T> Array<out T>.toMutableList(): MutableList<T> fun ByteArray.toMutableList(): MutableList<Byte> fun ShortArray.toMutableList(): MutableList<Short> fun IntArray.toMutableList(): MutableList<Int> fun LongArray.toMutableList(): MutableList<Long> fun FloatArray.toMutableList(): MutableList<Float> fun DoubleArray.toMutableList(): MutableList<Double> fun BooleanArray.toMutableList(): MutableList<Boolean> fun CharArray.toMutableList(): MutableList<Char> ومع المجموعات أيضًا: fun <T> Iterable<T>.toMutableList(): MutableList<T> fun <T> Collection<T>.toMutableList(): MutableList<T> القيمة المعادة تُعاد قائمة متغيرة تحوي جميع عناصر المصفوفة أو المجموعة المعطاة. أمثلة استعمال الدالة ()toMutableList لتحويل مصفوفة إلى قائمة متغيرة: fun main(args: ...

تعيد الدالة toHashSet()‎ كائنًا من النوع HashSet لجميع عناصر المصفوفة أو المجموعة التي استُدعيت معها. البنية العامة fun <T> Array<out T>.toHashSet(): HashSet<T> fun ByteArray.toHashSet(): HashSet<Byte> fun ShortArray.toHashSet(): HashSet<Short> fun IntArray.toHashSet(): HashSet<Int> fun LongArray.toHashSet(): HashSet<Long> fun FloatArray.toHashSet(): HashSet<Float> fun DoubleArray.toHashSet(): HashSet<Double> fun BooleanArray.toHashSet(): HashSet<Boolean> fun CharArray.toHashSet(): HashSet<Char> fun <T> Iterable<T>.toHashSet(): HashSet<T> القيمة المعادة يعاد كائن من النوع HashSet لجميع عناصر المصفوفة أو المجموعة المعطاة. أمثلة استعمال الدالة ()toHashSet مع مصفوفة مؤلفة من ستة عناصر: import java.util.Arrays fun main(args: Array<String>) { ...

تحول الدالة toMutableSet()‎ المصفوفة أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع MutableSet؛ تحافظ المجموعة المُعادة على نفس ترتيب تكرار المصفوفة أو المجموعة التكرارية الأصلية. البنية العامة يمكن استدعاء الدالة toMutableSet()‎ مع المصفوفات والمجموعات التكرارية: fun <T> Array<out T>.toMutableSet(): MutableSet<T> fun ByteArray.toMutableSet(): MutableSet<Byte> fun ShortArray.toMutableSet(): MutableSet<Short> fun IntArray.toMutableSet(): MutableSet<Int> fun LongArray.toMutableSet(): MutableSet<Long> fun FloatArray.toMutableSet(): MutableSet<Float> fun DoubleArray.toMutableSet(): MutableSet<Double> fun BooleanArray.toMutableSet(): MutableSet<Boolean> fun CharArray.toMutableSet(): MutableSet<Char> fun <T> Iterable<T>.toMutableSet(): MutableSet<T> القيمة المعادة تعاد مجموعة من النوع MutableSet تحوي جميع عناصر ...

تحول الدالة toSet()‎ المصفوفة أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع Set. تحافظ المجموعة المُعادة على نفس ترتيب تكرار المصفوفة أو المجموعة التكرارية الأصلية.  البنية العامة يمكن استدعاء الدالة toSet()‎ مع المصفوفات والمجموعات التكرارية: fun <T> Array<out T>.toSet(): Set<T> fun ByteArray.toSet(): Set<Byte> fun ShortArray.toSet(): Set<Short> fun IntArray.toSet(): Set<Int> fun LongArray.toSet(): Set<Long> fun FloatArray.toSet(): Set<Float> fun DoubleArray.toSet(): Set<Double> fun BooleanArray.toSet(): Set<Boolean> fun CharArray.toSet(): Set<Char> fun <T> Iterable<T>.toSet(): Set<T> القيمة المعادة تعاد مجموعة من النوع Set تحوي جميع عناصر المصفوفة أو المجموعة التكرارية المعطاة. أمثلة استعمال الدالة ()toSet لتحويل مصفوفة إلى مجموعة من ...

تحول الدالة toList()‎ المصفوفة أو المجموعة التكرارية أو الخريطة التي استُدعيت معها إلى قائمة. البنية العامة يمكن استدعاء الدالة toList()‎ مع المصفوفات أو المجموعات التكرارية أو الخرائط: fun <T> Array<out T>.toList(): List<T> fun ByteArray.toList(): List<Byte> fun ShortArray.toList(): List<Short> fun IntArray.toList(): List<Int> fun LongArray.toList(): List<Long> fun FloatArray.toList(): List<Float> fun DoubleArray.toList(): List<Double> fun BooleanArray.toList(): List<Boolean> fun CharArray.toList(): List<Char> fun <T> Iterable<T>.toList(): List<T> fun <K, V> Map<out K, V>.toList(): List<Pair<K, V>> القيمة المعادة تعاد قائمة تحوي جميع عناصر المصفوفة أو المجموعة التكرارية أو جميع أزواج ...

تحول الدالة toSortedSet()‎ المصفوفة أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع SortedSet ثمَّ تعيدها فقط إن لم يمرَّر إليها أي شيء، أو ترتِّبها وفقًا لترتيب معيَّن ثمَّ تعيدها إن مرِّرت إليها دالة مقارنة. البنية العامة يمكن استدعاء الدالة toSortedSet()‎ مع المصفوفات أو المجموعات التكرارية: fun <T : Comparable<T>> Array<out T>.toSortedSet(): SortedSet<T> fun ByteArray.toSortedSet(): SortedSet<Byte> fun ShortArray.toSortedSet(): SortedSet<Short> fun IntArray.toSortedSet(): SortedSet<Int> fun LongArray.toSortedSet(): SortedSet<Long> fun FloatArray.toSortedSet(): SortedSet<Float> fun DoubleArray.toSortedSet(): SortedSet<Double> fun BooleanArray.toSortedSet(): SortedSet<Boolean> fun CharArray.toSortedSet(): SortedSet<Char> fun <T : Comparable<T>> ...

يمثل الصنف Array مصفوفة (مصفوفة Java تحديدًا عند استهداف المنصة JVM). يمكن إنشاء نسخ من هذا الصنف باستعمال الدوال ()‎arrayOf و ()‎arrayOfNulls و ()‎emptyArray الخاصة بالمكتبة القياسية. للمزيد من المعلومات حول المصفوفات، ارجع إلى قسم "المصفوفات" في توثيق الأنواع الأساسية. class Array<T> الدوال البانية <int> تنشِئ الدالة Array()‎ البانية مصفوفةً بحجم size مُحدَّدٍ، حيث يُحسَب كلُّ عنصرٍ فيها عبر استدعاء الدالة init المُحدَّدة، والتي تُعيد عنصرًا في المصفوفة بحسب الفهرس (index) المُعطى. الدوال والخاصيات size تمثِّل الخاصيّة size عدد العناصر الموجودة في المصفوفة (array). iterator تعيد هذه الدالة ...

يمثل الصنف FloatArray مصفوفةً من الأعداد العشرية. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []float. class FloatArray الدوال البانية <init> تنشئ الدالة FloatArray()‎ البانية مصفوفة جديدة من النوع FloatArray (أي مصفوفة من الأعداد العشرية) بحجم معين، وتحوي قيمًا محدَّدة أو القيم 0. الخاصيات size تمثِّل الخاصيّة FloatArray.size عدد العناصر الموجودة في المصفوفة ذات النوع FloatArray. الدوال get تجلب الدالة get()‎ عنصرًا ذي فهرس محدد من المصفوفة. iterator ينشئ الدالة iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set تضبط الدالة set()‎ قيمة عنصر ذي ...

يمثل الصنف CharArray مصفوفةً من الأعداد العشرية المضاعفة. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []char. class DoubleArray الدوال البانية (Constructors) <init> تنشئ الدالة DoubleArray()‎ البانية مصفوفة جديدة من النوع DoubleArray (أي مصفوفة من الأعداد العشرية المضاعفة [double]) بحجم معين، وتحوي قيمًا محدَّدة أو القيم 0. الخاصيات size تمثِّل الخاصيّة DoubleArray.size عدد العناصر الموجودة في المصفوفة ذات النوع DoubleArray. الدوال get تجلب الدالة get()‎ عنصرًا ذي فهرس محدد من المصفوفة. iterator تنشئ الدالة iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set تضبط الدالة set()‎ قيمة عنصر ذي ...

يمثل الصنف CharArray مصفوفةً من المحارف. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []char. class CharArray الدوال البانية <init> تنشئ الدالة CharArray()‎ البانية مصفوفة جديدة من النوع CharArray (أي مصفوفة من الحروف) بحجم معين، وتحوي قيمًا محدَّدة أو القيمة '‎\u0000' التي تمثل حرفًا عدميًّا. الخاصيات size تمثِّل الخاصيّة CharArray.size عدد العناصر الموجودة في المصفوفة ذات النوع CharArray. الدوال get يجلب التابع get()‎ عنصرًا ذي فهرس محدد من المصفوفة. iterator تنشئ الدالة iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set تضبط الدالة set()‎ قيمة عنصر ذي فهرس ...

يمثل الصنف CharArray مصفوفةً من المحارف. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []char. class CharArray الدوال البانية <init> تنشئ الدالة CharArray()‎ البانية مصفوفة جديدة من النوع CharArray (أي مصفوفة من الحروف) بحجم معين، وتحوي قيمًا محدَّدة أو القيمة '‎\u0000' التي تمثل حرفًا عدميًّا. الخاصيات size تمثِّل الخاصيّة CharArray.size عدد العناصر الموجودة في المصفوفة ذات النوع CharArray. الدوال get يجلب التابع get()‎ عنصرًا ذي فهرس محدد من المصفوفة. iterator تنشئ الدالة iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set تضبط الدالة set()‎ قيمة عنصر ذي فهرس ...

يمثل الصنف CharArray مصفوفةً من الأعداد العشرية المضاعفة. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []char. class DoubleArray الدوال البانية (Constructors) <init> تنشئ الدالة DoubleArray()‎ البانية مصفوفة جديدة من النوع DoubleArray (أي مصفوفة من الأعداد العشرية المضاعفة [double]) بحجم معين، وتحوي قيمًا محدَّدة أو القيم 0. الخاصيات size تمثِّل الخاصيّة DoubleArray.size عدد العناصر الموجودة في المصفوفة ذات النوع DoubleArray. الدوال get تجلب الدالة get()‎ عنصرًا ذي فهرس محدد من المصفوفة. iterator تنشئ الدالة iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set تضبط الدالة set()‎ قيمة عنصر ذي ...

يمثل الصنف FloatArray مصفوفةً من الأعداد العشرية. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []float. class FloatArray الدوال البانية <init> تنشئ الدالة FloatArray()‎ البانية مصفوفة جديدة من النوع FloatArray (أي مصفوفة من الأعداد العشرية) بحجم معين، وتحوي قيمًا محدَّدة أو القيم 0. الخاصيات size تمثِّل الخاصيّة FloatArray.size عدد العناصر الموجودة في المصفوفة ذات النوع FloatArray. الدوال get تجلب الدالة get()‎ عنصرًا ذي فهرس محدد من المصفوفة. iterator ينشئ الدالة iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set تضبط الدالة set()‎ قيمة عنصر ذي ...

تحول الدالة toMap()‎ الكائن المستدعى معها إلى خريطة أو تضيف محتوى ذلك الكائن إلى خريطة موجودة مسبقًا. البنية العامة إن استدعيت الدالة toMap()‎ مع مصفوفة أو مجموعة تكرارية أو سلسلة مكونة من أزواج، فستعيد خريطة تحوي كل تلك الأزواج؛ تحافظ الخريطة المُعادة على نفس ترتيب تكرار الخريطة الأصلية: fun <K, V> Iterable<Pair<K, V>>.toMap(): Map<K, V> fun <K, V> Array<out Pair<K, V>>.toMap(): Map<K, V> fun <K, V> Sequence<Pair<K, V>>.toMap(): Map<K, V> وإن استدعيت الدالة toMap()‎ مع مصفوفة أو مجموعة تكرارية أو سلسلة ...

يمثل الصنف ByteArray مصفوفةً من البايتات. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []byte. class ByteArray الدوال البانية <int> تنشئ الدالة ByteArray()‎ البانية مصفوفة جديدة من النوع ByteArray (أي حجم كل عنصر منها بايتًا واحدًا) بحجم معين، إذ تحوي قيمًا محدَّدة أو القيم 0. الخاصيات size تمثِّل الخاصيّة size عدد العناصر الموجودة في المصفوفة ذات النوع ByteArray. الدوال get يجلب التابع get()‎ عنصرًا ذي فهرس محدد من المصفوفة. iterator ينشئ التابع iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set يضبط التابع set()‎ قيمة ...

يمثل الصنف BooleanArray مصفوفةً من القيم المنطقية. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []boolean. class BooleanArray الدوال البانية init تنشئ الدالة BooleanArray()‎ البانية مصفوفة جديدة من الصنف BooleanArray بحجم معين تحوي قيمًا منطقية محدَّدة أو القيمة false المنطقية. الخاصيات size تمثِّل الخاصيّة size عدد العناصر الموجودة في المصفوفة. الدوال get يجلب التابع get()‎ عنصرًا ذي فهرس محدد من المصفوفة. iterator ينشئ التابع iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set يضبط التابع set()‎ قيمة عنصر ذي فهرس محدد موجود ...

يمثل الصنف BooleanArray مصفوفةً من القيم المنطقية. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []boolean. class BooleanArray الدوال البانية init تنشئ الدالة BooleanArray()‎ البانية مصفوفة جديدة من الصنف BooleanArray بحجم معين تحوي قيمًا منطقية محدَّدة أو القيمة false المنطقية. الخاصيات size تمثِّل الخاصيّة size عدد العناصر الموجودة في المصفوفة. الدوال get يجلب التابع get()‎ عنصرًا ذي فهرس محدد من المصفوفة. iterator ينشئ التابع iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set يضبط التابع set()‎ قيمة عنصر ذي فهرس محدد موجود ...

يمثل الصنف ByteArray مصفوفةً من البايتات. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []byte. class ByteArray الدوال البانية <int> تنشئ الدالة ByteArray()‎ البانية مصفوفة جديدة من النوع ByteArray (أي حجم كل عنصر منها بايتًا واحدًا) بحجم معين، إذ تحوي قيمًا محدَّدة أو القيم 0. الخاصيات size تمثِّل الخاصيّة size عدد العناصر الموجودة في المصفوفة ذات النوع ByteArray. الدوال get يجلب التابع get()‎ عنصرًا ذي فهرس محدد من المصفوفة. iterator ينشئ التابع iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set يضبط التابع set()‎ قيمة ...

ترتِّب الدالة sortedArrayWith()‎ جميع عناصر المصفوفة التي استُدعيت معها وفقًا للمُقارِن المُمرّر إليها ثمَّ تضع الناتج في مصفوفة جديدة.  البنية العامة fun <T> Array<out T>.sortedArrayWith( comparator: Comparator<in T> ): Array<out T> المعاملات comparator المقارن الذي سترتَّب العناصر وفقًا له. القيمة المعادة تُعاد مصفوفة جديدة تضم عناصر المصفوفة المعطاة بعد ترتيبها وفقًا للمُقارِن comparator المعطى. أمثلة استعمال الدالة ()sortedArrayWith لترتيب عناصر مصفوفة وفقًا لناتج طرح قيمة العنصر اللاحق من قيمة العنصر السابق: import java.util.Arrays fun main(args: Array<String>) { val array = arrayOf(1, 9, -3, ...

ترتِّب الدالة sortedArrayDescending()‎ جميع عناصر المصفوفة التي استُدعيت معها تنازليًّا ثمَّ تضع الناتج في مصفوفة جديدة.  البنية العامة fun <T : Comparable<T>> Array<T>.sortedArrayDescending(): Array<T> fun ByteArray.sortedArrayDescending(): ByteArray fun ShortArray.sortedArrayDescending(): ShortArray fun IntArray.sortedArrayDescending(): IntArray fun LongArray.sortedArrayDescending(): LongArray fun FloatArray.sortedArrayDescending(): FloatArray fun DoubleArray.sortedArrayDescending(): DoubleArray fun CharArray.sortedArrayDescending(): CharArray القيمة المعادة تعاد مصفوفة جديدة تضم عناصر المصفوفة المعطاة بعد ترتيبها تصاعديًّا. أمثلة استعمال الدالة ()sortedArrayDescending لترتيب عناصر مصفوفة تنازليًّا: import java.util.Arrays fun main(args: Array<String>) { val array = arrayOf(1, 9, -3, 7, 5, 6) ...

ترتِّب الدالة sortedArray()‎ جميع عناصر المصفوفة التي استُدعيت معها تصاعديًّا ثمَّ تضع الناتج في مصفوفة جديدة.  البنية العامة fun <T : Comparable<T>> Array<T>.sortedArray(): Array<T> fun ByteArray.sortedArray(): ByteArray fun ShortArray.sortedArray(): ShortArray fun IntArray.sortedArray(): IntArray fun LongArray.sortedArray(): LongArray fun FloatArray.sortedArray(): FloatArray fun DoubleArray.sortedArray(): DoubleArray fun CharArray.sortedArray(): CharArray القيمة المعادة تعاد مصفوفة جديدة تضم عناصر المصفوفة المعطاة بعد ترتيبها تصاعديًّا. أمثلة استعمال الدالة ()sortedArray لترتيب عناصر مصفوفة تصاعديًّا: import java.util.Arrays fun main(args: Array<String>) { val array = arrayOf(1, 9, -3, 7, 5, 6) ...

ترتِّب الدالة sortedDescending()‎ جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها تنازليًّا ثمَّ تضع الناتج في قائمة. البنية العامة fun <T : Comparable<T>> Array<out T>.sortedDescending(): List<T> fun ByteArray.sortedDescending(): List<Byte> fun ShortArray.sortedDescending(): List<Short> fun IntArray.sortedDescending(): List<Int> fun LongArray.sortedDescending(): List<Long> fun FloatArray.sortedDescending(): List<Float> fun DoubleArray.sortedDescending(): List<Double> fun CharArray.sortedDescending(): List<Char> fun <T : Comparable<T>> Iterable<T>.sortedDescending(): List<T> القيمة المعادة تُعاد قائمة تضم عناصر المصفوفة أو المجموعة التكرارية المعطاة بعد ترتيبها تنازليًّا. أمثلة استعمال الدالة ()sortedDescending لترتيب عناصر مصفوف تنازليًّا: fun main(args: Array<String>) { val array = arrayOf(1, ...

ترتِّب الدالة sorted()‎ جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها تصاعديًّا ثمَّ تضع الناتج في قائمة. البنية العامة fun <T : Comparable<T>> Array<out T>.sorted(): List<T> fun ByteArray.sorted(): List<Byte> fun ShortArray.sorted(): List<Short> fun IntArray.sorted(): List<Int> fun LongArray.sorted(): List<Long> fun FloatArray.sorted(): List<Float> fun DoubleArray.sorted(): List<Double> fun CharArray.sorted(): List<Char> fun <T : Comparable<T>> Iterable<T>.sorted(): List<T> القيمة المعادة تُعاد قائمة تضم عناصر المصفوفة أو المجموعة التكرارية المعطاة بعد ترتيبها تصاعديًّا. أمثلة استعمال الدالة ()sorted لترتيب عناصر مصفوفة تصاعديًّا: fun main(args: Array<String>) { val array = ...

تمثل الخاصيّة size‎ عدد العناصر الموجودة في المصفوفة (array). البنية العامة val size: Int القيم المعادة يعاد عددٌ صحيحٌ يساوي عدد العناصر في المصفوفة المُحدَّدة. أمثلة استخدام الخاصية size مع مصفوفة أعداد صحيحة (integers): fun main(args: Array<String>) {    val arrayOfInt = arrayOf(1, 2, 3, 4, 5)    println(arrayOfInt.size)   // 5 } استخدام الخاصية size مع مصفوفة سلاسل نصية (strings): fun main(args: Array<String>) {    val arrayOfStr = arrayOf("programming","kotlin")    println(arrayOfStr.size)   // 2 } استخدام الخاصية size مع مصفوفة فارغة (empty): fun main(args: Array<String>) {    val emptyArray: Array<Int> = arrayOf()    println(emptyArray.size)  // 0 } انظر ...

توسع هذه الواجهة الصنف 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). الدوال ...

تحذف الدالة distinct()‎ العناصر المتكررة الموجودة في المصفوفة أو المجموعة التي استُدعيت معها وتعيد الناتج في قائمة. تُرتَّب العناصر في القائمة الناتجة بنفس ترتيبها في المصفوفة أو المجموعة الأصليَّة. البنية العامة تستدعى الدالة distinct()‎ مع مصفوفة: fun <T> Array<out T>.distinct(): List<T> fun ByteArray.distinct(): List<Byte> fun ShortArray.distinct(): List<Short> fun IntArray.distinct(): List<Int> fun LongArray.distinct(): List<Long> fun FloatArray.distinct(): List<Float> fun DoubleArray.distinct(): List<Double> fun BooleanArray.distinct(): List<Boolean> fun CharArray.distinct(): List<Char> وتستدعى مع مجموعة: fun <T> Iterable<T>.distinct(): List<T> القيم المعادة تُعاد قائمة تحتوي على عناصر المصفوفة ...

تجلب الدالة getOrNull()‎ عنصرًا ذا فهرس مُحدَّد من المصفوفة أو المجموعة التي استُدعيت معها أو تعيد القيمة null إن كان الفهرس المعطى يقع خارج حدود المصفوفة أو المجموعة. البنية العامة يمكن استدعاء الدالة getOrElse()‎ مع المصفوفات: fun <T> Array<out T>.getOrNull(index: Int): T? fun ByteArray.getOrNull(index: Int): Byte? fun ShortArray.getOrNull(index: Int): Short? fun IntArray.getOrNull(index: Int): Int? fun LongArray.getOrNull(index: Int): Long? fun FloatArray.getOrNull(index: Int): Float? fun DoubleArray.getOrNull(index: Int): Double? fun BooleanArray.getOrNull(index: Int): Boolean? fun CharArray.getOrNull(index: Int): Char? ويمكن استدعاؤها مع المجموعات أيضًا: fun <T> List<T>.getOrNull(index: ...

تنشئ الدالة to()‎ عنصرًا من النوع Pair مكونًا من الكائن الذي استُدعي معه والمعامل الذي مُرّر إليه، أي العنصر that. البنية العامة infix fun <A, B> A.to(that: B): Pair<A, B> يُلاحَظ وجود الكلمة المفتاحية infix للدلالة على أن هذه الدالة يمكن استدعاؤها بنمط التدوين الداخليّ (infix notation)؛ أي من خلال حذف المعامل . والأقواس () المُستخدَمَين في الاستدعاء عادةً، وللمزيد من التفاصيل راجع توثيق التدوين الداخلي للدوال (infix functions). المعاملات that الكائن المراد استعماله مع الكائن المعطى في إنشاء كائن من ...

تجلب الدالة elementAt()‎ عنصرًا ذي فهرس معيَّن من المصفوفة أو المجموعة التي استُدعيت معها. إن كان فهرس العنصر المعطى خارج حدود المصفوفة أو المجموعة، فستُطلق الدالة الاستثناء IndexOutOfBoundsException. البنية العامة يمكن استدعاء الدالة elementAt()‎ مع المصفوفات: inline fun <T> Array<out T>.elementAt(index: Int): T inline fun ByteArray.elementAt(index: Int): Byte inline fun ShortArray.elementAt(index: Int): Short inline fun IntArray.elementAt(index: Int): Int inline fun LongArray.elementAt(index: Int): Long inline fun FloatArray.elementAt(index: Int): Float inline fun DoubleArray.elementAt(index: Int): Double inline fun BooleanArray.elementAt(index: Int): Boolean inline fun ...

تُستخدَم هذه الخاصيّة للحصول على الفهرس (index) الأخير للمصفوفة أو القائمة (list)، أو القيمة ‎-1 إن كانت المصفوفة أو القائمة فارغةً. البنية العامة توفّر لغة Kotlin الخاصيّة lastIndex للمصفوفات من الأنواع المختلفة كما يلي: val <T> Array<out T>.lastIndex: IntRange val ByteArray.lastIndex: IntRange val ShortArray.lastIndex: IntRange val IntArray.lastIndex: IntRange val LongArray.lastIndex: IntRange val FloatArray.lastIndex: IntRange val DoubleArray.lastIndex: IntRange val BooleanArray.lastIndex: IntRange val CharArray.lastIndex: IntRange وكذلك للقائمة (list): val <T> List<T>.lastIndex: Int القيم المعادة يعاد الفهرس الأخير للمصفوفة أو القائمة، أو القيمة ‎-1 إن كانت المصفوفة أو القائمة فارغة. أمثلة استخدام ...

ترتِّب الدالة sortDescending()‎ المصفوفة أو القائمة المتغيرة (MutableList) التي استُدعيت معها تنازليًّا.  البنية العامة يمكن استدعاء الدالة sortDescending()‎ مع المصفوفات والقوائم المتغيرة:  fun <T : Comparable<T>> Array<out T>.sortDescending() fun ByteArray.sortDescending() fun ShortArray.sortDescending() fun IntArray.sortDescending() fun LongArray.sortDescending() fun FloatArray.sortDescending() fun DoubleArray.sortDescending() fun CharArray.sortDescending() fun <T : Comparable<T>> MutableList<T>.sortDescending() أمثلة استعمال الدالة ()sortDescending لترتيب عناصر مصفوفة تنازليًّا: import java.util.Arrays fun main(args: Array<String>) { val array = arrayOf(1, 9, -3, 7, 5, 6) array.sortDescending() print(Arrays.toString(array)) // [9, ...

تجلب الدالة elementAtOrNull()‎ عنصرًا ذي فهرس معيَّن من المصفوفة أو المجموعة التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود المصفوفة أو المجموعة، فستُعيد الدالة القيمة العدمية null. البنية العامة يمكن استدعاء الدالةelementAtOrNull()‎ مع المصفوفات: inline fun <T> Array<out T>.elementAtOrNull(index: Int): T? inline fun ByteArray.elementAtOrNull(index: Int): Byte? inline fun ShortArray.elementAtOrNull(index: Int): Short? inline fun IntArray.elementAtOrNull(index: Int): Int? inline fun LongArray.elementAtOrNull(index: Int): Long? inline fun FloatArray.elementAtOrNull(index: Int): Float? inline fun DoubleArray.elementAtOrNull(index: Int): Double? inline fun BooleanArray.elementAtOrNull(index: Int): Boolean? inline fun CharArray.elementAtOrNull(index: Int): Char? ومع ...

تعيد الدالة drop()‎ قائمة تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء أول n عنصر. البنية العامة fun <T> Array<out T>.drop(n: Int): List<T> fun ByteArray.drop(n: Int): List<Byte> fun ShortArray.drop(n: Int): List<Short> fun IntArray.drop(n: Int): List<Int> fun LongArray.drop(n: Int): List<Long> fun FloatArray.drop(n: Int): List<Float> fun DoubleArray.drop(n: Int): List<Double> fun BooleanArray.drop(n: Int): List<Boolean> fun CharArray.drop(n: Int): List<Char> fun <T> Iterable<T>.drop(n: Int): List<T> المعاملات n عدد صحيح يمثل عدد العناصر المراد حذفها من بداية المصفوفة أو المجموعة المعطاة. القيم المعادة تُعاد قائمة ...

تشِّفر الدالة contentDeepHashCode()‎ محتوى المصفوفة التي استُدعيت معها كما لو كانت قائمة إلى شيفرة Hash. تعامل المصفوفات المُتشعبة مثل القوائم أيضًا. إن حَوَت المصفوفة نفسها في أي مستوى من المستويات المتشعبة، فسيكون سلوك الدالة غير محدَّد. البنية العامة inline fun <T> Array<out T>.contentDeepHashCode(): Int الإصدار المطلوب: Kotlin 1.1 وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة). القيم المعادة  شيفرة Hash لمحتوى المصفوفة المعطاة كما لو كانت قائمة. أمثلة استخدام الدالة ()contentDeepHashCode مع المصفوفات المتشعبة ...

تمثِّل الخاصيّة size عدد العناصر الموجودة في المصفوفة. البنية العامة val size: Int القيم المعادة يعاد عددٌ صحيحٌ يمثِّل عدد العناصر في المصفوفة المعطاة. أمثلة استعمال الخاصية size مع مصفوفة منطقية يراد معرفة عدد عناصرها: fun main(args: Array<String>) { val array = BooleanArray(4) {it % 2 == 0} println(array.size) // 4 } استعمال الخاصية size لمعرفة إن كانت المصفوفة فارغة أم لا: fun main(args: Array<String>) { ...

ترتِّب الدالة sortedWith()‎ جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها وفقًا للمُقارِن المُمرّر إليها ثمَّ تضع الناتج في قائمة. البنية العامة fun <T> Array<out T>.sortedWith( comparator: Comparator<in T> ): List<T> fun ByteArray.sortedWith( comparator: Comparator<in Byte> ): List<Byte> fun ShortArray.sortedWith( comparator: Comparator<in Short> ): List<Short> fun IntArray.sortedWith( comparator: Comparator<in Int> ): List<Int> fun LongArray.sortedWith( comparator: Comparator<in Long> ): List<Long> fun FloatArray.sortedWith( comparator: Comparator<in Float> ): List<Float> fun DoubleArray.sortedWith( ...

تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection). البنية العامة توفّر لغة Kotlin الخاصيّة indices للمصفوفات من الأنواع المختلفة كما يلي: val <T> Array<out T>.indices: IntRange val ByteArray.indices: IntRange val ShortArray.indices: IntRange val IntArray.indices: IntRange val LongArray.indices: IntRange val FloatArray.indices: IntRange val DoubleArray.indices: IntRange val BooleanArray.indices: IntRange val CharArray.indices: IntRange وكذلك للمجموعة (collection) val Collection<*>.indices: IntRange القيم المعادة الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection). أمثلة استخدام الخاصية indices‎ مع المصفوفات: fun main(args: Array<String>) { val array = arrayOf(4,5,7,9) ...

تمثِّل الخاصيّة DoubleArray.size عدد العناصر الموجودة في المصفوفة ذات النوع DoubleArray. البنية العامة val size: Int القيم المعادة يعاد عددٌ صحيحٌ يمثِّل عدد العناصر في المصفوفة المعطاة. أمثلة استعمال الخاصيّة size لمعرفة عدد العناصر الموجود في مصفوفة من النوع DoubleArray: fun main(args: Array<String>) { val array = DoubleArray(6) print(array.size) // 6 } انظر أيضًا الصنف ‎DoubleArray. الدالة DoubleArray()‎: تنشئ مصفوفة جديدة من النوع DoubleArray (أي مصفوفة من الأعداد العشرية المضاعفة) بحجم معين، وتحوي قيمًا محدَّدة أو القيم 0.  الدالة ()get: تجلب عنصرًا ذي فهرس محدد من المصفوفة. الدالة iterator()‎: تنشئ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على ...

تمثِّل الخاصيّة FloatArray.size عدد العناصر الموجودة في المصفوفة ذات النوع FloatArray. البنية العامة val size: Int القيم المعادة يعاد عددٌ صحيحٌ يمثِّل عدد العناصر في المصفوفة المعطاة. أمثلة استعمال الخاصيّة size لمعرفة عدد العناصر الموجود في مصفوفة من النوع FloatArray: fun main(args: Array<String>) { val array = FloatArray(6) print(array.size) // 6 } انظر أيضًا الصنف ‎FloatArray. الدالة FloatArray()‎: تنشئ مصفوفة جديدة من النوع FloatArray (أي مصفوفة من الأعداد العشرية) بحجم معين، وتحوي قيمًا محدَّدة أو القيم 0.  الدالة ()get: تجلب عنصرًا ذي فهرس محدد من المصفوفة. الدالة iterator()‎: تنشئ عنصرًا ...

تعيد الدالة reversedArray()‎ مصفوفةً تضم عناصر المصفوفة التي استُدعيت معها بترتيب معكوس. البنية العامة fun <T> Array<T>.reversedArray(): Array<T> fun ByteArray.reversedArray(): ByteArray fun ShortArray.reversedArray(): ShortArray fun IntArray.reversedArray(): IntArray fun LongArray.reversedArray(): LongArray fun FloatArray.reversedArray(): FloatArray fun DoubleArray.reversedArray(): DoubleArray fun BooleanArray.reversedArray(): BooleanArray fun CharArray.reversedArray(): CharArray القيم المعادة تُعاد مصفوفة تضم عناصر المصفوفة المعطاة بترتيب معكوس. أمثلة استعمال الدالة ()reversedArray لعكس ترتيب عناصر مصفوفة: import java.util.Arrays fun main(args: Array<String>) { var array = arrayOf(0, 1, 2, 3, 4, 5) print(Arrays.toString(array.reversedArray())) // [5, ...

تمثِّل الخاصيّة CharArray.size عدد العناصر الموجودة في المصفوفة ذات النوع CharArray. البنية العامة val size: Int القيم المعادة يعاد عددٌ صحيحٌ يمثِّل عدد العناصر في المصفوفة المعطاة. أمثلة استعمال الخاصيّة size لمعرفة عدد العناصر الموجود في مصفوفة من النوع CharArray: fun main(args: Array<String>) { val array = CharArray(6) print(array.size) // 6 } انظر أيضًا الصنف ‎CharArray. الدالة CharArray()‎: تنشئ مصفوفة جديدة من النوع CharArray (أي مصفوفة من الحروف) بحجم معين، وتحوي قيمًا محدَّدة أو القيمة '‎\u0000' التي تمثل حرفًا عدميًّا.   التابع ()get: يجلب عنصرًا ذي فهرس محدد من ...

تعيد الدالة orEmpty()‎ المصفوفة أو المجموعة أو القائمة أو الخريطة التي استُدعيت معها إن لم تكن مساويةً للقيمة null، أو تعيد كائنًا فارغًا يقابل الكائن المعطى (مصفوفة فارغة، أو مجموعة فارغة ...إلخ.) خلاف ذلك. البنية العامة يمكن استدعاء الدالة orEmpty()‎ مع المصفوفات والمجموعات والقوائم والخرائط والمجموعات التي من النوع Set: inline fun <reified T> Array<out T>?.orEmpty(): Array<out T> inline fun <T> Collection<T>?.orEmpty(): Collection<T> inline fun <T> List<T>?.orEmpty(): List<T> inline fun <K, V> Map<K, V>?.orEmpty(): Map<K, V> (source) inline fun <K, V> Map<K, V>?.orEmpty(): Map<K, V> ...

تقطع الدالة sliceArray()‎ جزءًا محدَّدًا من المصفوفة التي استُدعيت معها ثمَّ تعيده في مصفوفة أو قائمة بحسب الوسيط الممرر إليها.  البنية العامة إن مرِّر كائن من النوع Collection إلى الدالة sliceArray()‎، فستُعاد مصفوفة تحوي عناصر المصفوفة التي استُدعيت معها والموجودة في الموقع الذي يحدده الوسيط indices: fun <T> Array<T>.sliceArray( indices: Collection<Int> ): Array<T> fun ByteArray.sliceArray(indices: Collection<Int>): ByteArray fun ShortArray.sliceArray( indices: Collection<Int> ): ShortArray fun IntArray.sliceArray(indices: Collection<Int>): IntArray fun LongArray.sliceArray(indices: Collection<Int>): LongArray fun FloatArray.sliceArray( indices: Collection<Int> ): FloatArray ...

تجلب الدالة min()‎ أصغر عنصر في المصفوفة أو المجموعة التي استُدعيت معها. البنية العامة fun Array<out Double>.min(): Double? fun Array<out Float>.min(): Float? fun FloatArray.min(): Float? fun DoubleArray.min(): Double? fun Iterable<Double>.min(): Double? fun Iterable<Float>.min(): Float? fun <T : Comparable<T>> Array<out T>.min(): T? fun ByteArray.min(): Byte? fun ShortArray.min(): Short? fun IntArray.min(): Int? fun LongArray.min(): Long? fun CharArray.min(): Char? fun <T : Comparable<T>> Iterable<T>.min(): T? الإصدار المطلوب: Kotlin 1.1. القيم المعادة يُعاد أصغر عنصر في المصفوفة أو المجموعة المعطاة، أو القيمة null إن كانت تلك المصفوفة أو ...

تجلب الدالة max()‎ أكبر عنصر في المصفوفة أو المجموعة التي استُدعيت معها. البنية العامة fun Array<out Double>.max(): Double? fun Array<out Float>.max(): Float? fun FloatArray.max(): Float? fun DoubleArray.max(): Double? fun Iterable<Double>.max(): Double? fun Iterable<Float>.max(): Float? fun <T : Comparable<T>> Array<out T>.max(): T? fun ByteArray.max(): Byte? fun ShortArray.max(): Short? fun IntArray.max(): Int? fun LongArray.max(): Long? fun CharArray.max(): Char? fun <T : Comparable<T>> Iterable<T>.max(): T? الإصدار المطلوب: Kotlin 1.1. القيم المعادة يُعاد أكبر عنصر في المصفوفة أو المجموعة المعطاة، أو القيمة null إن كانت تلك المصفوفة أو ...

تجلب الدالة first()‎ أول عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها إن لم يمرر إليها أي شيء، أو أول عنصر يحق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها. إن كانت المصفوفة أو المجموعة التي استُدعيت الدالة first()‎ عبرها فارغة أو لم يكن هناك أي عنصر يحقق الدالة المنطقية الممرَّرة إليها، فستُطلِق الدالة الاستثناء NoSuchElementException. البنية العامة يمكن استدعاء الدالة first()‎ بدون تمرير أية معاملات: fun <T> Array<out T>.first(): T fun ByteArray.first(): Byte fun ShortArray.first(): Short fun IntArray.first(): ...

تعيد الدالة dropLast()‎ قائمة تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء آخر n عنصر. البنية العامة fun <T> Array<out T>.dropLast(n: Int): List<T> fun ByteArray.dropLast(n: Int): List<Byte> fun ShortArray.dropLast(n: Int): List<Short> fun IntArray.dropLast(n: Int): List<Int> fun LongArray.dropLast(n: Int): List<Long> fun FloatArray.dropLast(n: Int): List<Float> fun DoubleArray.dropLast(n: Int): List<Double> fun BooleanArray.dropLast(n: Int): List<Boolean> fun CharArray.dropLast(n: Int): List<Char> fun <T> List<T>.dropLast(n: Int): List<T> المعاملات n عدد صحيح يمثل عدد العناصر المراد حذفها من نهاية المصفوفة أو المجموعة المعطاة. القيم المعادة تُعاد ...

تجلب الدالة elementAtOrElse()‎ عنصرًا ذي فهرس معيَّن من المصفوفة أو المجموعة التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود المصفوفة أو المجموعة، فستُعيد الدالة ناتج استدعاء دالة معينة. البنية العامة يمكن استدعاء الدالة elementAtOrElse()‎ مع المصفوفات: inline fun <T> Array<out T>.elementAtOrElse( index: Int, defaultValue: (Int) -> T ): T inline fun ByteArray.elementAtOrElse( index: Int, defaultValue: (Int) -> Byte ): Byte inline fun ShortArray.elementAtOrElse( index: Int, ...

تُعيد الدالة asList()‎ قائمةً (list) تُغلّف المصفوفة الأصلية التي استُدعيت عبرها. البنية العامة تختلف بحسب نوع المصفوفة: fun <T> Array<out T>.asList(): List<T> fun ByteArray.asList(): List<Byte> fun ShortArray.asList(): List<Short> fun IntArray.asList(): List<Int> fun LongArray.asList(): List<Long> fun FloatArray.asList(): List<Float> fun DoubleArray.asList(): List<Double> fun BooleanArray.asList(): List<Boolean> fun CharArray.asList(): List<Char> القيم المعادة قائمة (list) تُغلّف المصفوفة الأصلية التي استُدعيت عبرها. أمثلة تعرِّف الشيفرة الآتية مصفوفةً باسم array مكوَّنة من حرفين باستخدام الدالة ()arrayOf، ثم تنشئ قائمةً باسم list من المصفوفة array وذلك باستخدام الدالة ()asList ...

تعيد الدالة contentDeepToString()‎ سلسلة نصية تمثِّل محتوى المصفوفة التي استُدعيت معها كما لو كانت قائمة. تعامل المصفوفات المُتشعبة مثل معاملة القوائم أيضًا. إن حَوَت المصفوفة نفسها في أي مستوى من المستويات المتشعبة، فسيعاد ذلك المرجع (reference) بالشكل "[...]" لمنع العَودية (recursion). البنية العامة inline fun <T> Array<out T>.contentDeepToString(): String الإصدار المطلوب: Kotlin 1.1 وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة). القيم المعادة تُعاد سلسلة نصية تمثل محتوى المصفوفة كما لو كانت قائمة. أمثلة تعرف ...

تجلب الدالة take()‎ أول n عنصر من المصفوفة أو المجموعة التكرارية التي استُدعيت معها وتضعها في قائمة. البنية العامة fun <T> Array<out T>.take(n: Int): List<T> fun ByteArray.take(n: Int): List<Byte> fun ShortArray.take(n: Int): List<Short> fun IntArray.take(n: Int): List<Int> fun LongArray.take(n: Int): List<Long> fun FloatArray.take(n: Int): List<Float> fun DoubleArray.take(n: Int): List<Double> fun BooleanArray.take(n: Int): List<Boolean> fun CharArray.take(n: Int): List<Char> fun <T> Iterable<T>.take(n: Int): List<T> المعاملات n عدد صحيح يمثل عدد العناصر الأولى المراد جلبها من المصفوفة أو المجموعة التكرارية المعطاة. إن كانت القيمة المعطاة لهذا المعامل ...

تتحقَّق الدالة singleOrNull()‎ من حواية المصفوفة أو المجموعة أو القائمة التي استُدعيت معها عنصرًا واحدًا فقط، أو عنصرًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده، أو تعيد القيمة null خلاف ذلك. البنية العامة إن استدعيت الدالة singleOrNull()‎ مع مصفوفة أو مجموعة أو قائمة دون تمرير أي معامل، فستتحقَّق من احتواء تلك المصفوفة أو المجموعة أو القائمة على عنصر واحد فقط ثمَّ تعيده. وفي حال كانت تلك المصفوفة أو المجموعة أو القائمة فارغةً أو تحوي أكثر من عنصر واحد، فستعيد الدالة singleOrNull()‎ القيمة null: fun <T> Array<out T>.singleOrNull(): T? ...

ترتِّب الدالة sortWith()‎ جميع عناصر المصفوفة أو القائمة المتغيرة (MutableList) التي استُدعيت معها أو جزءًا محدَّدًا منها تنازليًا وفقًا للمُقارن المُمرّر إليها. البنية العامة إن استدعيت الدالة sortWith()‎ مع تمرير مقارِن comparator، فسترتِّب جميع عناصر المصفوفة أو القائمة المتغيرة التي استُدعيت معها وفقًا للترتيب الذي يحدده هذا المقارن المعطى: fun <T> Array<out T>.sortWith(comparator: Comparator<in T>) fun <T> MutableList<T>.sortWith(comparator: Comparator<in T>) أمَّا إن استدعيت الدالة مع تمرير مقارِن comparator والعددين fromIndex و toIndex، فسترتب المجال الذي يحدده هذين العددين من المصفوفة التي استُدعيت ...

تجلب الدالة takeLast()‎ آخر n عنصر من المصفوفة أو المجموعة التكرارية التي استُدعيت معها وتضعها في قائمة.  البنية العامة fun <T> Array<out T>.takeLast(n: Int): List<T> fun ByteArray.takeLast(n: Int): List<Byte> fun ShortArray.takeLast(n: Int): List<Short> fun IntArray.takeLast(n: Int): List<Int> fun LongArray.takeLast(n: Int): List<Long> fun FloatArray.takeLast(n: Int): List<Float> fun DoubleArray.takeLast(n: Int): List<Double> fun BooleanArray.takeLast(n: Int): List<Boolean> fun CharArray.takeLast(n: Int): List<Char> fun <T> List<T>.takeLast(n: Int): List<T> المعاملات n عدد صحيح يمثل عدد العناصر الأخيرة المراد جلبها من المصفوفة أو المجموعة التكرارية المعطاة. إن كانت القيمة المعطاة لهذا المعامل أكبر من طول المصفوفة أو المجموعة التكرارية، فستعاد ...

تعيد الدالة Array.iterator()‎ عنصرًا تكراريًّا (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة. البنية العامة operator fun iterator(): Iterator<T> ويُلاحظ وجود الكلمة المفتاحية operator للدلالة على أنّ هذه الدالة مرتبطٌ بمعامل التكرار (iteration operator) المستخدم في شيفرة المثال اللاحق. القيم المعادة يعاد عنصرٌ تكراريٌّ (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة. أمثلة تنشِئ الشيفرة الآتية مصفوفةً من ستة أعدادٍ صحيحةٍ بالاعتماد على الدالة arrayOf ثم تخصِّص لهذه المصفوفة عنصرًا تكراريًا (iterator) باستخدام الدالة iterator()‎ لاستخدامه في ...

ترتِّب الدالة sortedBy()‎ جميع عناصر المصفوفة أو المجموعة التكرارية (Iterable) التي استُدعيت معها تصاعديًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر ثمَّ تضع الناتج في قائمة. البنية العامة inline fun <T, R : Comparable<R>> Array<out T>.sortedBy( crossinline selector: (T) -> R? ): List<T> inline fun <R : Comparable<R>> ByteArray.sortedBy( crossinline selector: (Byte) -> R? ): List<Byte> inline fun <R : Comparable<R>> ShortArray.sortedBy( crossinline selector: (Short) -> R? ): List<Short> inline fun <R ...

ترتِّب الدالة sortedByDescending()‎ جميع عناصر المصفوفة أو المجموعة التكرارية (Iterable) التي استُدعيت معها تنازليًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر ثمَّ تضع الناتج في قائمة. البنية العامة inline fun <T, R : Comparable<R>> Array<out T>.sortedByDescending( crossinline selector: (T) -> R? ): List<T> inline fun <R : Comparable<R>> ByteArray.sortedByDescending( crossinline selector: (Byte) -> R? ): List<Byte> inline fun <R : Comparable<R>> ShortArray.sortedByDescending( crossinline selector: (Short) -> R? ): List<Short> inline fun <R ...

تتحقَّق الدالة single()‎ من حواية المصفوفة أو المجموعة أو القائمة التي استُدعيت معها عنصرًا واحدًا فقط أو عنصرًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده أو تطلق استثناءً خلاف ذلك. البنية العامة إن استدعيت الدالة single()‎ مع مصفوفة أو مجموعة أو قائمة دون تمرير أي معامل، فستتحقَّق من احتواء تلك المصفوفة أو المجموعة أو القائمة على عنصر واحد فقط ثمَّ تعيده. وفي حال كانت تلك المصفوفة أو المجموعة أو القائمة فارغةً أو تحوي أكثر من عنصر واحد، فستطلق الدالة single()‎ استثناءً: fun <T> Array<out T>.single(): T fun ByteArray.single(): ...