نتائج البحث

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

تشبه هذه الدالة filterTo()‎ الدالة filter()‎ في جميع النواحي باستثناء أنها تضيف الناتج إلى المعامل المُمرَّر إليها. الجدير بالذكر أنّه ينبغي أن يكون ذلك المعامل المعطى مجموعةً قابلةً للتغيير (MutableCollection) إن استدعيت الدالة مع مصفوفة أو مجموعة، أو خريطةً قابلة للتغيير (MutableMap) إن استدعيت الدالة مع خريطة. البنية العامة يمكن استدعاء الدالة filterTo()‎ مع المصفوفات أو المجموعات: inline fun <T, C : MutableCollection<in T>> Array<out T>.filterTo( destination: C, predicate: (T) -> Boolean ): C inline ...

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

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

ترشِّح الدالة filter()‎ عناصر المصفوفة أو المجموعة أو أزواج الخرائط المعطاة التي تحقِّق شرطًا معيَّنًا ثمّ تعيدها. البنية العامة يمكن استدعاء الدالة filter()‎ مع المصفوفات والمجموعات: inline fun <T> Array<out T>.filter( predicate: (T) -> Boolean ): List<T> inline fun ByteArray.filter( predicate: (Byte) -> Boolean ): List<Byte> inline fun ShortArray.filter( predicate: (Short) -> Boolean ): List<Short> inline fun IntArray.filter( predicate: (Int) -> Boolean ): List<Int> inline fun LongArray.filter( predicate: (Long) ...

تجلب الدالة indexOfLast()‎ فهرس آخر عنصر يحقِّق شرطًا معيَّنًا من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها. البنية العامة يمكن استدعاء الدالة indexOfLast()‎ مع المصفوفات والمجموعات والقوائم: inline fun <T> Array<out T>.indexOfLast( predicate: (T) -> Boolean ): Int inline fun ByteArray.indexOfLast( predicate: (Byte) -> Boolean ): Int inline fun ShortArray.indexOfLast( predicate: (Short) -> Boolean ): Int inline fun IntArray.indexOfLast( predicate: (Int) -> Boolean ): Int inline fun LongArray.indexOfLast( predicate: ...

تجلب الدالة indexOfFirst()‎ فهرس أول عنصر يحقِّق شرطًا معيَّنًا من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها. البنية العامة يمكن استدعاء الدالة indexOfFirst()‎ مع المصفوفات والمجموعات والقوائم: inline fun <T> Array<out T>.indexOfFirst( predicate: (T) -> Boolean ): Int inline fun ByteArray.indexOfFirst( predicate: (Byte) -> Boolean ): Int inline fun ShortArray.indexOfFirst( predicate: (Short) -> Boolean ): Int inline fun IntArray.indexOfFirst( predicate: (Int) -> Boolean ): Int inline fun LongArray.indexOfFirst( ...

تشبه الدالة filterIndexedTo()‎ الدالة filterIndexed()‎ تمامًا باستثناء أنها تضيف الناتج إلى كائن موجود مسبقًا بدلًا من أن تعيده.   البنية العامة inline fun <T, C : MutableCollection<in T>> Array<out T>.filterIndexedTo( destination: C, predicate: (index: Int, T) -> Boolean ): C inline fun <C : MutableCollection<in Byte>> ByteArray.filterIndexedTo( destination: C, predicate: (index: Int, Byte) -> Boolean ): C inline fun <C : MutableCollection<in Short>> ShortArray.filterIndexedTo( destination: C, ...

تجلب الدالة takeLastWhile()‎ آخر عناصر محققة لشرطٍ محدَّدٍ من المصفوفة أو القائمة التي استُدعيت معها. البنية العامة inline fun <T> Array<out T>.takeLastWhile( predicate: (T) -> Boolean ): List<T> inline fun ByteArray.takeLastWhile( predicate: (Byte) -> Boolean ): List<Byte> inline fun ShortArray.takeLastWhile( predicate: (Short) -> Boolean ): List<Short> inline fun IntArray.takeLastWhile( predicate: (Int) -> Boolean ): List<Int> inline fun LongArray.takeLastWhile( predicate: (Long) -> Boolean ): List<Long> inline fun FloatArray.takeLastWhile( predicate: (Float) -> ...

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

تتحقق الدالة endsWith()‎ إن كانت السلسلة النصية أو سلسلة المحارف التي استُدعيت معها تنتهي بمحرف معين أو لاحقة معينة. البنية العامة fun String.endsWith( suffix: String, ignoreCase: Boolean = false ): Boolean fun CharSequence.endsWith( char: Char, ignoreCase: Boolean = false ): Boolean fun CharSequence.endsWith( suffix: CharSequence, ignoreCase: Boolean = false ): Boolean المعاملات suffix سلسلة نصية أو سلسلة من المحارف تمثل اللاحقة التي يراد التحقق ...

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

تعيد الدالة count()‎ عدد جميع عناصر المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها أو العناصر التي تحقق شرطًا معينًا. البنية العامة إن استدعيت الدالة count()‎ مع مصفوفة دون تمرير أي معامل، فستعيد عدد عناصر هذه المصفوفة. inline fun <T> Array<out T>.count(): Int inline fun ByteArray.count(): Int inline fun ShortArray.count(): Int inline fun IntArray.count(): Int inline fun LongArray.count(): Int inline fun FloatArray.count(): Int inline fun DoubleArray.count(): Int inline fun BooleanArray.count(): Int inline fun CharArray.count(): Int وإن استدعيت مع تمرير الدالة predicate المنطقيَّة ...

تقسم الدالة partition()‎ المصفوفة أو المجموعة التي استُدعيت معها إلى قسمين؛ الأول يضم العناصر التي تحقِّق شرطًا محدَّدًا، والثاني يضم العناصر الأخرى المتبقيَّة. البنية العامة يمكن استدعاء الدالة partition()‎ مع المصفوفات والمجموعات: inline fun <T> Array<out T>.partition( predicate: (T) -> Boolean ): Pair<List<T>, List<T>> inline fun ByteArray.partition( predicate: (Byte) -> Boolean ): Pair<List<Byte>, List<Byte>> inline fun ShortArray.partition( predicate: (Short) -> Boolean ): Pair<List<Short>, List<Short>> inline fun IntArray.partition( predicate: (Int) -> Boolean ): ...

تتحقق الدالة all()‎ إن كانت جميع محارف سلسلة معينة من المحارف محققةً لشرط معين. البنية العامة inline fun CharSequence.all( predicate: (Char) -> Boolean ): Boolean المعاملات predicate دالةٌ تمثل الشرط المراد تطبيقه على كل محرف من محارف السلسلة النصية المعطاة، إذ يمرر إليها محرفًا وتعيد لهذا المحرف قيمة منطقية. القيم المعادة تعاد القيمة true إن كانت جميع محارف سلسلة المحارف المعطاة محققةً للشرط المحدد في المعامل predicate، أو تعاد القيمة false خلاف ذلك. أمثلة استعمال الدالة all()‎ للتحقق ...

النوع boolean هو نوع غير قياسي، وهو اسمٌ بديل للنوع bool المُعرَّف في أردوينو. يُنصَح باستعمال النوع القياسي bool عوضًا عن هذا النوع الذي يماثله تمامًا. البنية العامة bool var = val; يمثِّل var اسم المتغير المراد التصريح عنه، وتمثِّل val القيمة المراد إسنادها إلى هذا المتغير وهي إمَّا true أو false.  أمثلة يوضح المثال التالي كيفية استعمال النوع boolean لجعل الضوء المتصل بالرجل 5 يومض كلما ضُغِط على القاطعة الموصولة بالرجل 13: int LEDpin = 5; // ضوء ...

الكائن Boolean هو كائن مُغلِّف لنوع القيم الأوليّة boolean (المنطقية). البنية العامة new Boolean([value]) value وسيط اختياري، وهو القيمة الابتدائية للكائن Boolean. الوصف القيمة المُمرَّرة كوسيط إلى الدالة البانية Boolean ستُحوَّل إلى قيمة منطقية إن كان ذلك ضروريًا؛ وإذا لم تُحدَّد القيمة، أو كانت 0 أو -0 أو null أو false أو NaN أو undefined أو سلسلة نصية فارغة "" فستكون القيمة الابتدائية للكائن هي false؛ وجميع القيمة الأخرى بما في ذلك أيّة كائنات أو السلسلة النصية "false" ستُنشِئ كائنًا ...

يجلب التابع get()‎ عنصرًا ذي فهرس محدد من المصفوفة. يمكن الاستعاضة عن هذا التابع باستخدام معامل الفهرسة (index operator) المتمثل بالقوسين [] بالشكل: value = arr[index]‎ البنية العامة operator fun get(index: Int): Boolean وجود الكلمة المفتاحية operator يدل على أنّ هذا التابع مرتبط بمعامل الفهرسة الذي ذكرناه آنفًا. المعاملات index عدد صحيح يمثل فهرس العنصر المراد جلبه. القيم المعادة يعاد العنصر ذو الفهرس index المحدِّد والموجود في المصفوفة المعطاة. أمثلة استعمال التابع get()‎ لجلب العنصر الثاني من مصفوفة قيم منطقية: fun ...

تتحقَّق الدالة contentEquals()‎ من تساوي مصفوفتين بنيويًا (structurally equal)، أي إن كان لهما نفس العناصر وبنفس العدد والترتيب. البنية العامة inline infix fun <T> Array<out T>.contentEquals( other: Array<out T> ): Boolean inline infix fun ByteArray.contentEquals( other: ByteArray ): Boolean inline infix fun ShortArray.contentEquals( other: ShortArray ): Boolean inline infix fun IntArray.contentEquals( other: IntArray ): Boolean inline infix fun LongArray.contentEquals( other: LongArray ): Boolean inline infix fun FloatArray.contentEquals( other: ...

تتحقَّق الدالة none()‎ إن كانت المصفوفة أو المجموعة أو الخريطة التي استدعيت معها فارغةً، أو إن لم يكن هنالك أي عنصر من تلك العناصر محقِّقًا لشرط معين. البنية العامة يمكن استدعاء الدالة none()‎ مع المصفوفات والمجموعات والخرائط دون تمرير أية معامل إليها: fun <T> Array<out T>.none(): Boolean fun ByteArray.none(): Boolean fun ShortArray.none(): Boolean fun IntArray.none(): Boolean fun LongArray.none(): Boolean fun FloatArray.none(): Boolean fun DoubleArray.none(): Boolean fun BooleanArray.none(): Boolean fun CharArray.none(): Boolean fun <T> Iterable<T>.none(): Boolean (source) fun <K, V> Map<out K, V>.none(): ...