نتائج البحث

تعيد الدالةunaryMinus()‎ القيمة السالبة المقابلة للعدد العشري (float) الذي استُدعي معها. البنية العامة operator fun unaryMinus(): Float وجود الكلمة المفتاحيّة operator يدل على أنّ هذه الدالة مرتبطٌة بمعامل تكرار (iteration operator). القيمة المعادة يعاد عدد عشري يمثل القيمة السالبة للعدد العشري المعطى. أمثلة استعمال الدالة ()unaryMinus لإعادة القيمة السالبة لعددٍ عشريٍّ موجب وآخر سالب: fun main(args: Array<String>) { val x: Float = 52.5f val y = x.unaryMinus() println(y) // ...

تتحقق الدالة isWhitespace()‎ إن كان المحرف الذي استٌدعي معها هو مسافة بيضاء (whitespace). البنية العامة actual fun Char.isWhitespace(): Boolean القيم المعادة تعاد القيمة true إن كان المحرف الذي استٌدعي معها هو مسافة بيضاء، أو القيمة false خلاف ذلك. أمثلة استعمال الدالة isWhitespace()‎ لمعرفة أي المحرفين التاليين هو مسافة بيضاء: fun main(args: Array<String>) { val x = '_' val y = ' ' print(x.isWhitespace()) // false ...

تجلب الدالة 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 ...

تُراكِم الدالة reduce()‎ قيمة عنصر بدءًا من العنصر الأول عبر تطبيق عملية معينة من يسار العناصر المعطاة إلى يمينها على القيمة المتراكمة الحالية وعلى العنصر التالي ثم تُعيد قيمة العنصر النهائي الناتج. البنية العامة inline fun <S, T : S> Array<out T>.reduce( operation: (acc: S, T) -> S ): S inline fun ByteArray.reduce( operation: (acc: Byte, Byte) -> Byte ): Byte inline fun ShortArray.reduce( operation: (acc: Short, Short) -> Short ): Short inline fun IntArray.reduce( ...

تجلب الدالة 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: ...

تشبه الدالة mapIndexedNotNullTo()‎ الدالة mapIndexedNotNull()‎ تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها. البنية العامة inline fun <R : Any, C : MutableCollection<in R>> CharSequence.mapIndexedNotNullTo( destination: C, transform: (index: Int, Char) -> R? ): C وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة (inline functions)). المعاملات destination مجموعة متغيرة تمثل الوجهة التي سيضاف إليها الناتج الذي تعيده الدالة transform. transform دالةٌ تطبق على كل محرف من محارف السلسلة المعطاة. يمرر إليها فهرس ...

توازن الدالة compareTo()‎ بين الكائن الذي استُدعي معها والكائن المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية. البنية العامة abstract operator fun compareTo(other: T): Int وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other الكائن الآخر المراد موازنته مع الكائن المعطى. القيمة المعادة تعاد القيمة 0 إن كانت القيمة المعطاة ...

تجلب الدالة 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) -> ...

تجلب الدالة getOrNull()‎ محرفًا ذا فهرس مُحدَّد من سلسلة المحارف التي استُدعيت معها أو تعيد القيمة null إن كان الفهرس المعطى يقع خارج حدود سلسلة المحارف. البنية العامة fun CharSequence.getOrNull(index: Int): Char? المعاملات index عدد صحيح يمثل فهرس المحرف المراد جلبه. القيم المعادة يعاد المحرف ذو الفهرس index من سلسلة المحارف المعطاة، أو تعاد القيمة null إن كان الفهرس المعطى يقع خارج حدود سلسلة المحارف. أمثلة مثالٌ على استعمال الدالة ()getOrNull: fun main(args: Array<String>) { val str = "Hsoub" print(str.getOrNull(3)) // => u ...

تحذف الدالة removeSuffix()‎ لاحقة معينة من سلسلة من المحارف أو سلسلة نصية. البنية العامة fun CharSequence.removeSuffix( suffix: CharSequence ): CharSequence fun String.removeSuffix(suffix: CharSequence): String المعاملات suffix سلسلة من المحارف تمثل اللاحقة المراد حذفها. القيم المعادة تعاد سلسلة من المحارف أو سلسلة نصية جديدة تحوي سلسلة المحارف أو السلسلة النصية المعطاة بعد إزالة اللاحقة prefix منها. إن لم تكن اللاحقة suffix موجودة في بداية سلسلة المحارف أو السلسلة النصية المعطاة، فستعاد نسخة عن سلسلة المحارف أو السلسلة النصية تلك. أمثلة ...

تتحقَّق الدالة 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(): ...

تتحقق الدالة isIdentifierIgnorable()‎ إن كان المحرف الذي استٌدعي معها محرفًا قابلًا للإهمال (ignorable character) في مُعرِّفات جافا (Java identifier) أو معرِّفات الترميز الموحَّد (Unicode identifier). البنية العامة inline fun Char.isIdentifierIgnorable(): Boolean المنصة المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كان المحرف المعطى محرفًا قابلًا للإهمال (ignorable character) في مُعرِّفات جافا (Java identifier) أو معرِّفات الترميز الموحَّد (Unicode identifier)، أو تعاد القيمة false ...

تتحقق الدالة isLowerCase()‎ إن كان الحرف الذي استٌدعي معها حرفًا صغيرًا (lower case). البنية العامة inline fun Char.isLowerCase(): Boolean وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كان الحرف الذي استٌدعي معها حرفًا صغيرًا، أو القيمة false خلاف ذلك. أمثلة استعمال الدالة isLowerCase()‎ لمعرفة إن كان الحرفان التاليان متساويين: fun main(args: Array<String>) { val x = 'a' val y = ...

ترتِّب الدالة 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 = ...

تنشئ الدالة rangeTo()‎ مجالًا يقع بين القيمة التي استدعيت معها والقيمة المُمرّرة إليها. البنية العامة operator fun rangeTo(other: Byte): IntRange operator fun rangeTo(other: Short): IntRange operator fun rangeTo(other: Int): IntRange operator fun rangeTo(other: Long): وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other العدد الآخر المراد تطبيق العملية عليه. القيمة المعادة يعاد مجالٌ ينحصر بين القيمة التي استدعيت مع الدالة والقيمة الممررة إليها. أمثلة استعمال الدالة ()rangeTo لإنشاء مجال من الأعداد ينحصر بين العدد ...

تجمع الدالة sumBy()‎ جميع نواتج تطبيق دالة معيَّنة على كل محرف من محارف سلسلة المحارف التي استُدعيت معها. الفرق بين الدالة sumBy()‎ والدالة sumByDouble()‎ هو في نوع القيمة التي تستطيع الدالة الممرَّر إلى كلٍّ منهما إعادتها، إذ تعيد الدالة المُمرَّرة إلى sumBy()‎ عددًّا صحيحًا (integer) بينما يمكن أن تعيد الدالة الممرَّرة إلى sumByDouble()‎ عددًا عشريًّا مضاعفًا (double).  البنية العامة inline fun CharSequence.sumBy(selector: (Char) -> Int): Int يُلاحَظ وجود الكلمة المفتاحية inline التي تدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). المعاملات selector الدالة التي يراد تطبيقها على كل ...

تتحقق الدالة isBlank()‎ إن كانت سلسلة المحارف التي استٌدعيت معها فارغةً أو تحوي محارف المسافات البيضاء (whitespace characters) فقط. البنية العامة actual fun CharSequence.isBlank(): Boolean القيم المعادة تعاد القيمة true إن كانت سلسلة المحارف التي استٌدعيت معها فارغةً أو تحوي محارف المسافات البيضاء فقط، أو تعاد القيمة false خلاف ذلك. أمثلة مثالٌ على استعمال الدالة isBlank()‎: fun main(args: Array<String>) { val str1 = " hsoub " val str2 = " ...

تجلب الدالة 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 إن كانت تلك المصفوفة أو ...

تحول الدالة 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>‎) أو المجموعة  التي استُدعيت معها ...

يمثل الثابت Float.POSITIVE_INFINITY قيمة موجبة لا نهائية (infinity) لعدد عشري (float). البنية العامة val POSITIVE_INFINITY: Float أمثلة استخدام الثابت Float.POSITIVE_INFINITY لطباعة عدد عشري موجب لا نهائي: fun main(args: Array<String>) { println(Float.POSITIVE_INFINITY ) // Infinity } انظر أيضًا الثابت Float.MAX_VALUE: يمثل أكبر قيمة موجبة نهائية (finite) لعدد عشري (float). الثابت Float.MIN_VALUE: يمثل أًصغر قيمة موجبة غير صفرية يمكن أن يأخذها عدد عشري (float). الثابت Float.NEGATIVE_INFINITY: يمثل قيمة سالبة لا نهائية (infinity) لعدد عشري (float). الثابت ...