نتائج البحث
اذهب إلى التنقل
اذهب إلى البحث
الدالة Float.unaryMinus() في Kotlin
تعيد الدالة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() في Kotlin
تتحقق الدالة isWhitespace() إن كان المحرف الذي استٌدعي معها هو مسافة بيضاء (whitespace). البنية العامة actual fun Char.isWhitespace(): Boolean
القيم المعادة تعاد القيمة true إن كان المحرف الذي استٌدعي معها هو مسافة بيضاء، أو القيمة false خلاف ذلك. أمثلة استعمال الدالة isWhitespace() لمعرفة أي المحرفين التاليين هو مسافة بيضاء: fun main(args: Array<String>) {
val x = '_'
val y = ' '
print(x.isWhitespace()) // false
...
الدالة elementAt() في Kotlin
تجلب الدالة 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() في Kotlin
تُراكِم الدالة 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() في Kotlin
تجلب الدالة 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: ...
الدالة CharSequence.mapIndexedNotNullTo() في Kotlin
تشبه الدالة 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 دالةٌ تطبق على كل محرف من محارف السلسلة المعطاة. يمرر إليها فهرس ...
الدالة Comparable.compareTo() في Kotlin
توازن الدالة compareTo() بين الكائن الذي استُدعي معها والكائن المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية. البنية العامة abstract operator fun compareTo(other: T): Int
وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other الكائن الآخر المراد موازنته مع الكائن المعطى. القيمة المعادة تعاد القيمة 0 إن كانت القيمة المعطاة ...
الدالة takeLastWhile() في Kotlin
تجلب الدالة 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) -> ...
الدالة CharSequence.getOrNull() في Kotlin
تجلب الدالة 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() في Kotlin
تحذف الدالة removeSuffix() لاحقة معينة من سلسلة من المحارف أو سلسلة نصية. البنية العامة fun CharSequence.removeSuffix(
suffix: CharSequence
): CharSequence
fun String.removeSuffix(suffix: CharSequence): String
المعاملات suffix سلسلة من المحارف تمثل اللاحقة المراد حذفها. القيم المعادة تعاد سلسلة من المحارف أو سلسلة نصية جديدة تحوي سلسلة المحارف أو السلسلة النصية المعطاة بعد إزالة اللاحقة prefix منها. إن لم تكن اللاحقة suffix موجودة في بداية سلسلة المحارف أو السلسلة النصية المعطاة، فستعاد نسخة عن سلسلة المحارف أو السلسلة النصية تلك. أمثلة ...
الدالة none() في Kotlin
تتحقَّق الدالة 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() في Kotlin
تتحقق الدالة 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() في Kotlin
تتحقق الدالة 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() في Kotlin
ترتِّب الدالة 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 = ...
الدالة Byte.rangeTo() في Kotlin
تنشئ الدالة 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 لإنشاء مجال من الأعداد ينحصر بين العدد ...
الدالة CharSequence.sumBy() في Kotlin
تجمع الدالة sumBy() جميع نواتج تطبيق دالة معيَّنة على كل محرف من محارف سلسلة المحارف التي استُدعيت معها. الفرق بين الدالة sumBy() والدالة sumByDouble() هو في نوع القيمة التي تستطيع الدالة الممرَّر إلى كلٍّ منهما إعادتها، إذ تعيد الدالة المُمرَّرة إلى sumBy() عددًّا صحيحًا (integer) بينما يمكن أن تعيد الدالة الممرَّرة إلى sumByDouble() عددًا عشريًّا مضاعفًا (double). البنية العامة inline fun CharSequence.sumBy(selector: (Char) -> Int): Int
يُلاحَظ وجود الكلمة المفتاحية inline التي تدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). المعاملات selector الدالة التي يراد تطبيقها على كل ...
الدالة isBlank() في Kotlin
تتحقق الدالة isBlank() إن كانت سلسلة المحارف التي استٌدعيت معها فارغةً أو تحوي محارف المسافات البيضاء (whitespace characters) فقط. البنية العامة actual fun CharSequence.isBlank(): Boolean
القيم المعادة تعاد القيمة true إن كانت سلسلة المحارف التي استٌدعيت معها فارغةً أو تحوي محارف المسافات البيضاء فقط، أو تعاد القيمة false خلاف ذلك. أمثلة مثالٌ على استعمال الدالة isBlank(): fun main(args: Array<String>) {
val str1 = " hsoub "
val str2 = " ...
الدالة min() في Kotlin
تجلب الدالة 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() في Kotlin
تحول الدالة 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 في Kotlin
يمثل الثابت 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). الثابت ...
الدالة distinctBy() في Kotlin
تعيد الدالة distinctBy() قائمة تحتوي على العناصر الموجودة في المصفوفة أو المجموعة التي استُدعيت معها والتي تعطي نتيجة مختلفة عند تطبيق الدالة selector عليها فقط. تُرتَّب العناصر في القائمة الناتجة بنفس ترتيبها في المصفوفة أو المجموعة الأصليَّة. البنية العامة تستدعى الدالة distinctBy() مع مصفوفة: inline fun <T, K> Array<out T>.distinctBy(
selector: (T) -> K
): List<T>
inline fun <K> ByteArray.distinctBy(
selector: (Byte) -> K
): List<Byte>
inline fun <K> ShortArray.distinctBy(
selector: (Short) -> ...
الدالة dropWhile() في Kotlin
تُزيِل الدالة dropWhile() المحارف الأولى المحققة لشرط معين من محارف السلسلة النصية أو سلسلة المحارف التي استُدعيت معها. البنية العامة inline fun CharSequence.dropWhile(
predicate: (Char) -> Boolean
): CharSequence
inline fun String.dropWhile(
predicate: (Char) -> Boolean
): String
وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات predicate دالةٌ تمثل الشرط الذي سيُطبق على كل محرف من محارف السلسلة النصية أو سلسلة المحارف المعطاة. القيم المعادة تعاد سلسلة نصية أو سلسلة من المحارف تحوي جميع محارف ...
الثابت Float.NaN في Kotlin
يمثل الثابت Float.NaN قيمة غير عددية (Not a Number) لعدد من النوع Float. البنية العامة val NaN: Float
أمثلة استعمال الثابت Float.NaN لطباعة قيمة غير عددية للنوع Float: fun main(args: Array<String>) {
println(Float.NaN) // NaN
}
انظر أيضًا الثابت Float.MAX_VALUE: يمثل أكبر قيمة موجبة نهائية (finite) لعدد عشري (float). الثابت Float.MIN_VALUE: يمثل أًصغر قيمة موجبة غير صفرية يمكن أن يأخذها عدد عشري (float). الثابت Float.NEGATIVE_INFINITY: يمثل قيمة سالبة لا نهائية (infinity) لعدد عشري (float). ...
الدالة CharSequence.mapTo() في Kotlin
تشبه الدالة mapTo() الدالة map() باستثناء أنَّها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة. البنية العامة inline fun <R, C : MutableCollection<in R>> CharSequence.mapTo(
destination: C,
transform: (Char) -> R
): C
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة (inline functions)). المعاملات destination مجموعة متغيرة تمثل الوجهة التي سيضاف إليها الناتج الذي تعيده الدالة transform. transform دالةٌ تطبق على كل محرف من محارف السلسلة المعطاة. يمرر إليها محرفٌ ...
الدالة CharSequence.iterator() في Kotlin
تنشئ الدالة iterator() عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة محارف السلسلة المستدعاة معه. البنية العامة operator fun CharSequence.iterator(): CharIterator
وجود الكلمة المفتاحية operator يدل على أنّ هذه الدالة مرتبطٌة بمعامل التكرار (iteration operator، اطلع على المثال في الأسفل). القيم المعادة يعاد عنصرٌ تكراريٌّ (iterator) من أجل تكرار بنيةٍ (block) برمجيةٍ معينة على كافّة عناصر المصفوفة المعطاة. أمثلة مثالٌ على استعمال الدالة iterator(): fun main(args: Array<String>) {
val str = "Hsoub"
val ...
الدالة reversedArray() في Kotlin
تعيد الدالة 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, ...
الدالة lastOrNull() في Kotlin
تجلب الدالة lastOrNull() آخر عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو آخر عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها. تشبه هذه الدالةُ الدالةَ first() تمامًا باستثناء أنها تعيد القيمة null بدلًا من رمي استثناءٍ إن كانت المصفوفة أو المجموعة التي استُدعيت الدالة last() معها فارغة أو لم يكن هناك أي عنصر يحقق الدالة المنطقية الممرَّرة إليها. البنية العامة يمكن استدعاء الدالة lastOrNull() مع المصفوفات بدون تمرير أية معاملات: fun <T> Array<out T>.lastOrNull(): T?
fun ByteArray.lastOrNull(): Byte?
fun ShortArray.lastOrNull(): Short?
fun IntArray.lastOrNull(): Int? ...
الدالة isUpperCase() في Kotlin
تتحقق الدالة isUpperCase() إن كان الحرف الذي استٌدعي معها حرفًا كبيرًا (upper case). البنية العامة inline fun Char.isUpperCase(): Boolean
المنصة المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كان الحرف الذي استٌدعي معها حرفًا كبيرًا، أو القيمة false خلاف ذلك. أمثلة استعمال الدالة isUpperCase() لمعرفة إن كان الحرفان التاليان متساويين: fun main(args: Array<String>) {
val x = 'a'
...
الدالة toShortOrNull() في Kotlin
تحلّل الدالة toShortOrNull() السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد قصير. البنية العامة fun String.toShortOrNull(): Short?
الإصدار المطلوب:Kotlin 1.1. تحلّل الدالة toShortOrNull() السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد قصير في حال لم تكن السلسلة النصية تمثل عددًا، فستعيد الدالة القيمة null. fun String.toShortOrNull(radix: Int): Short?
الإصدار المطلوب:Kotlin 1.1. تحلّل الدالة toShortOrNull() السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد قصير في حال لم تكن السلسلة النصية تمثل عددًا، فستعيد الدالة القيمة null. أما في حال كان المعامل radix المعطى أساسًا غير صالح ...
الدالة CharSequence.asSequence() في Kotlin
تنشئ الدالة asSequence() نسخةً من الواجهة Sequence التي تغلّف سلسلة المحارف التي استُدعيت معها لأجل استعمالها في الحلقات التكرارية، إذ تعيد كل محرف من محارفها عندما تُستخدَم في حلقات التكرار (مثل حلقة for). البنية العامة fun CharSequence.asSequence(): Sequence<Char>
القيم المعادة كائن من الصنف Sequence التي تغلّف سلسلة المحارف المعطاة لاستعمالها في الحلقات التكرارية. أمثلة تعرّف الشيفرة التالية سلسلة نصية باسم str ثم تستدعي الدالة asSequence() معها وتُحيل القيمة المُعادة إلى المتغير seq ثم نطبَع الناتج باستخدام الحلقة التكرارية for: fun main(args: Array<String>) ...
الدالة reversed() في Kotlin
تعكس الدالة reversed() ترتيب محارف سلسلة المحارف أو السلسلة النصية التي استدعيت معها. البنية العامة fun CharSequence.reversed(): CharSequence
inline fun String.reversed(): String
وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد سلسلة من المحارف أو سلسلة نصية تحوي جميع محارف سلسلة المحارف أو السلسلة النصية المعطاة بترتيب معكوس. أمثلة مثالٌ على استعمال الدالة ()reversed: fun main(args: Array<String>) {
val str = "wikiHsoub"
println(str.reversed()) // buosHikiw
}
انظر ...
الدالة findAnyOf() في Kotlin
تبحث الدالة findAnyOf() عن أول ظهور لأيٍّ من السلاسل النصية المعطاة في سلسلة المحارف التي استُدعيت معها. البنية العامة fun CharSequence.findAnyOf(
strings: Collection<String>,
startIndex: Int = 0,
ignoreCase: Boolean = false
): Pair<Int, String>?
المعاملات strings مجموعةٌ من سلاسل نصية يراد البحث عنها ضمن سلسلة المحارف المعطاة. لتجنب الالتباس الناتج عند وجود محارف مشتركة بين السلاسل النصية الموجودة في المعامل strings، فإنّ الدالة findAnyOf() تبدأ من بداية سلسلة المحارف المعطاة ...
الدالة firstOrNull() في Kotlin
تجلب الدالة firstOrNull() أول محرف من محارف السلسلة التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو أول عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها. إن كانت سلسلة المحارف التي استُدعيت الدالة firstOrNull() معها فارغةً أو لم يكن هناك أي عنصر يحقق الدالة المنطقية الممرَّرة إليها، فستعيد الدالة القيمة null. البنية العامة fun CharSequence.firstOrNull(): Char?
inline fun CharSequence.firstOrNull(
predicate: (Char) -> Boolean
): Char?
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات predicate دالةٌ تمثل الشرط المراد ...
الصنف Boolean في Kotlin
يمثل الصنف Boolean قيمة منطقية وهي إما true أو false؛ في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثَّل كقيم للنوع boolean الأساسي. class Boolean : Comparable<Boolean>
الدوال and تجري الدالة and() العملية and المنطقية بين قيمتين منطقيتين؛ خلافًا للمعامل &&، تتحقق هذه الدالة من كلا القيمتين المنطقيتين. compareTo توازن الدالة compareTo() بين قيمة العنصر الذي استُدعيت معه والقيمة المُمرّرة إليه ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة ...
الدالة substringBeforeLast() في Kotlin
تجلب الدالة substringBeforeLast() كل الجزء الواقع قبل آخر ظهور لمحرف أو لسلسلة نصية معينة في سلسلة نصية. البنية العامة fun String.substringBeforeLast(
delimiter: Char,
missingDelimiterValue: String = this
): String (source)
fun String.substringBeforeLast(
delimiter: String,
missingDelimiterValue: String = this
): String
المعاملات delimiter المحرف أو السلسلة النصية التي يراد جلب كامل الجزء الواقع قبلها. missingDelimiterValue السلسلة النصية التي ستعاد في حال لم يكن المعامل delimiter موجودًا ضمن السلسلة النصية المعطاة. القيمة الافتراضية هي: this (أي السلسلة النصية المعطاة نفسها). القيم المعادة ...
الدالة CharSequence.indexOfLast() في Kotlin
تجلب الدالة indexOfLast() فهرس آخر محرف يحقِّق شرطًا معيَّنًا من سلسلة المحارف التي استُدعيت معها. البنية العامة inline fun CharSequence.indexOfLast(
predicate: (Char) -> Boolean
): Int
وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة (inline functions)). المعاملات predicate دالةٌ تمثل الشرط الذي سيطبَّق على كل محرف من محارف السلسلة المعطاة، إذ يمرر إليها المحرف ثم تعيد قيمة منطقية مقابلة له. القيم المعادة يُعاد عدد صحيح يمثل فهرس آخر محرف حقَّق الشرط المنطقي predicate المعطى في سلسلة المحارف المعطاة، ...
الدالة intersect() في Kotlin
تبحث الدالة intersect() عن العناصر المشتركة بين مصفوفتين أو مجموعتين ثمَّ تعيدها في مجموعة. تحافظ المجموعة المُعادة على ترتيب تكرار المصفوفة أو المجموعة الأصلية. البنية العامة يمكن استدعاء الدالة intersect() مع المصفوفات والمجموعات: infix fun <T> Array<out T>.intersect(
other: Iterable<T>
): Set<T>
infix fun ByteArray.intersect(
other: Iterable<Byte>
): Set<Byte>
infix fun ShortArray.intersect(
other: Iterable<Short>
): Set<Short>
infix fun IntArray.intersect(other: Iterable<Int>): Set<Int> (source)
infix fun LongArray.intersect(
other: Iterable<Long>
): Set<Long>
infix fun FloatArray.intersect(
...
الدالة String.capitalize() في Kotlin
تحول الدالة capitalize() الحرف الأول للسلسلة النصية التي استُدعيت معها إلى حرف كبير (uppercase). البنية العامة actual fun String.capitalize(): String
القيم المعادة تعاد نسخة من السلسلة النصية المعطاة بعد تحويل الحرف الأول فيها إلى حرف كبير، أو تعاد نسخة أخرى من تلك السلسلة النصية إن كان الحرف الأول فيها حرفًا كبيرًا أو كانت السلسلة فارغةً. أمثلة مثالٌ على استعمال الدالة ()capitalize: fun main(args: Array<String>) {
println("wiki hsoub".capitalize()) // Wiki hsoub
println("Wiki hsoub".capitalize()) // Wiki ...
الدالة firstOrNull() في Kotlin
تجلب الدالة firstOrNull() أول عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو أول عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها. إن كانت المصفوفة أو المجموعة التي استُدعيت الدالة first() معها فارغة أو لم يكن هناك أي عنصر يحقق الدالة المنطقية الممرَّرة إليها، فستعيد الدالة القيمة null. البنية العامة يمكن استدعاء الدالة firstOrNull() بدون تمرير أية معاملات: fun <T> Array<out T>.firstOrNull(): T?
fun ByteArray.firstOrNull(): Byte?
fun ShortArray.firstOrNull(): Short?
fun IntArray.firstOrNull(): ...
الدالة toShortArray() في Kotlin
تحول الدالة 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, ...
الدالة CharSequence.indexOfFirst() في Kotlin
تجلب الدالة indexOfFirst() فهرس أول محرف يحقِّق شرطًا معيَّنًا من سلسلة المحارف التي استُدعيت معها. البنية العامة inline fun CharSequence.indexOfFirst(
predicate: (Char) -> Boolean
): Int
وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة (inline functions)). المعاملات predicate دالةٌ تمثل الشرط الذي سيطبَّق على كل محرف من محارف السلسلة المعطاة، إذ يمرر إليها المحرف ثم تعيد قيمة منطقية مقابلة له. القيم المعادة يُعاد عدد صحيح يمثل فهرس أول محرف حقَّق الشرط المنطقي predicate المعطى في سلسلة المحارف المعطاة، ...
القيمة ERROR في Kotlin
تشير القيمة ERROR إلى وجود خطأٍ تولد نتيجة استعمال عنصر مهمل (deprecated element). انظر أيضًا القيمة WARNING: تشير إلى وجود تحذير تولد نتيجة استعمال عنصر مهمل (deprecated element). القيمة HIDDEN: تشير إلى أن العنصر المهمل (deprecated elements) غير متاح للاستخدام ضمن الشيفرة. مصادر صفحة ERROR في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.
الدالة toByte() في Kotlin
تحلّل الدالة toByte() السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد من النوع Byte. البنية العامة inline actual fun String.toByte(): Byte
تحلّل الدالة toByte() السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد من النوع Byte ثم تعيد الناتج. إن لم تكن السلسلة النصية تمثل عددًا، فسيُطلق الاستثناء NumberFormatException. inline actual fun String.toByte(radix: Int): Byte
بيئة التشغيل المطلوبة:Kotlin 1.1. تحلّل الدالة toByte() السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع Byte وتعيد الناتج. إن لم تكن السلسلة النصية تمثل عددًا، فسيُطلق ...
الدالة mapIndexedNotNullTo() في Kotlin
تشبه الدالة mapIndexedNotNullTo() الدالة mapIndexedNotNull() تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها. البنية العامة يمكن استدعاء الدالة mapIndexedNotNullTo() مع المصفوفات والمجموعات: inline fun <T, R : Any, C : MutableCollection<in R>> Array<out T>.mapIndexedNotNullTo(
destination: C,
transform: (index: Int, T) -> R?
): C
inline fun <T, R : Any, C : MutableCollection<in R>> Iterable<T>.mapIndexedNotNullTo(
destination: C,
transform: (index: Int, T) -> R?
): C
وجود الكلمة المفتاحية inline يدل ...
الدالة dropLast() في Kotlin
تُزيِل الدالة dropLast() آخر n محرف من محارف السلسلة النصية أو سلسلة المحارف التي استُدعيت معها. البنية العامة fun CharSequence.dropLast(n: Int): CharSequence
fun String.dropLast(n: Int): String
المعاملات n عدد صحيح يمثل عدد المحارف المراد حذفها من نهاية السلسلة النصية. القيم المعادة تعاد سلسلة نصية أو سلسلة من المحارف تحوي جميع محارف السلسلة النصية أو سلسلة المحارف المعطاة باستثناء آخر n محرف. أمثلة مثالٌ على استعمال الدالة ()dropLast: fun main(args: Array<String>) {
val str = "wiki Hsoub"
println(str.dropLast(0)) // wiki Hsoub
...
الدالة sumByDouble() في Kotlin
تجمع الدالة sumByDouble() جميع نواتج تطبيق دالة معيَّنة على كل عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها. الفرق بين الدالة sumByDouble() والدالة sumBy() هو في نوع القيمة التي تستطيع الدالة الممرَّر إلى كلٍّ منهما إعادتها، إذ تعيد الدالة المُمرَّرة إلى sumBy() عددًّا صحيحًا (integer) بينما يمكن أن تعيد الدالة الممررة إلى sumByDouble() عددًا عشريًّا مضاعفًا (double). البنية العامة يمكن استدعاء الدالة sumByDouble() مع المصفوفات والمجموعات: inline fun <T> Array<out T>.sumByDouble(
selector: (T) -> Double
): Double
inline fun ByteArray.sumByDouble(
...
الدالة isSurrogate() في Kotlin
تتحقق الدالة isSurrogate() إن كان المحرف الذي استٌدعي معها بديلًا لعدد بتات الترميز الموحد (Unicode surrogate code unit). البنية العامة fun Char.isSurrogate(): Boolean
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة المنطقية true إن كان المحرف الذي استٌدعي معها بديلًا لعدد بتات الترميز الموحد، أو القيمة false خلاف ذلك. أمثلة استعمال الدالة isSurrogate() لمعرفة أي المحرفيين التاليين هو بديل لعدد بتات الترميز الموحد: fun main(args: Array<String>) { ...
الدالة copyOfRange() في Kotlin
تنسخ الدالة copyOfRange() مجالًا محدَّدًا من المصفوفة التي استُدعيت معها. البنية العامة inline fun <T> Array<T>.copyOfRange(
fromIndex: Int,
toIndex: Int
): Array<T>
inline fun ByteArray.copyOfRange(
fromIndex: Int,
toIndex: Int
): ByteArray
inline fun ShortArray.copyOfRange(
fromIndex: Int,
toIndex: Int
): ShortArray
inline fun IntArray.copyOfRange(
fromIndex: Int,
toIndex: Int
): IntArray
inline fun LongArray.copyOfRange(
fromIndex: ...
الدالة Float.dec() في Kotlin
تنقص الدالة dec() العدد العشري (float) الذي استُدعي معها بمقدار 1 ثمَّ تعيد القيمة الناتجة. البنية العامة operator fun dec(): Float
وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). القيمة المعادة تعاد قيمة من النوع Float تمثل القيمة المعطاة بعد انقاصها بمقدار 1. أمثلة استعمال الدالة ()dec لإنقاص عدد عشري بمقدار 1 فقط: fun main(args: Array<String>) {
val x: Float = 3.4f
println(x.dec()) // 2.4
}
انظر أيضًا ...
الدالة Byte.toChar() في Kotlin
تحول الدالة toChar() القيمة العددية للكائن الذي استُدعي معها إلى الحرف المقابل في جدول ASCII، ويمكن تقطيعه إلى 16 بت إن كان ذلك ضروريًا. البنية العامة fun toChar(): Char
القيمة المعادة يعاد الحرف المقابل للقيمة العددية المعطاة. أمثلة استعمال الدالة ()toChar لتحويل قيم عددية إلى ما يقابلها من أحرف: fun main(args: Array<String>) {
val x: Byte = 97
val y: Byte = 50
val z: Byte = ...
الدالة CharSequence.foldRightIndexed() في Kotlin
تجمِّع الدالة foldRightIndexed() تراكميًّا ناتج تطبيق عملية معينة على فهرس كل محرف من محارف السلسلة المستدعاة معها (بدءًا من اليمين إلى اليسار) وقيمته والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت. البنية العامة inline fun <R> CharSequence.foldRightIndexed(
initial: R,
operation: (index: Int, Char, acc: R) -> R
): R
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات initial قيمة أولية يراد إضافتها مع ناتج تطبيق الدالة operation على أول ...
الدالة substring() في Kotlin
تعيد الدالة substring() جزءًا محددًا من السلسلة النصية أو سلسلة المحارف التي استُدعيت معها. البنية العامة inline actual fun String.substring(startIndex: Int): String
inline actual fun String.substring(
startIndex: Int,
endIndex: Int
): String
fun String.substring(range: IntRange): String
fun CharSequence.substring(range: IntRange): String
inline fun CharSequence.substring(
startIndex: Int,
endIndex: Int = length
): String
وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات startIndex عدد صحيح ...
الدالة CharSequence.associateByTo() في Kotlin
تشبه الدالة associateByTo() الدالة associateBy() تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا. البنية العامة inline fun <K, M : MutableMap<in K, in Char>> CharSequence.associateByTo(
destination: M,
keySelector: (Char) -> K
): M
inline fun <K, V, M : MutableMap<in K, in V>> CharSequence.associateByTo(
destination: M,
keySelector: (Char) -> K,
valueTransform: (Char) -> V
): M
وجود الكلمة المفتاحية inline يدل على أن هذه الدالة ...
الدالة Regex.replaceFirst() في Kotlin
تبدل الدالة replaceFirst() سلسلة النصية معينة مكان أول مطابقة للتعبير النمطي الذي استدعي معها في سلسلة المحارف المُمرّرة إليها. البنية العامة actual fun replaceFirst(
input: CharSequence,
replacement: String
): String
المعاملات input سلسلة المحارف المراد مطابقتها مع تعبير نمطي واستبدال محتوى المعامل replacement بأول مطابقة لها. replacement السلسلة النصية التي يراد أن تحل مكان المطابقة الأولى للتعبير النمطي المعطى في المعامل input. القيمة المعادة تعاد سلسلة نصية تحوي جميع محتوى المعامل input بعد تبديل السلسلة النصية replacement ...
الدالة isIdentifierIgnorable() في Kotlin
تتحقق الدالة isIdentifierIgnorable() إن كان المحرف الذي استٌدعي معها محرفًا قابلًا للإهمال (ignorable character) في مُعرِّفات جافا (Java identifier) أو معرِّفات الترميز الموحَّد (Unicode identifier). البنية العامة inline fun Char.isIdentifierIgnorable(): Boolean
المنصة المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كان المحرف المعطى محرفًا قابلًا للإهمال (ignorable character) في مُعرِّفات جافا (Java identifier) أو معرِّفات الترميز الموحَّد (Unicode identifier)، أو تعاد القيمة false ...
الدالة toBigDecimal() في Kotlin
تحلّل الدالة toBigDecimal() السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد من النوع BigDecimal. البنية العامة inline fun String.toBigDecimal(): BigDecimal
منصة التشغيل والإصدار المطلوبان: Kotlin 1.2 ، JVM. تحلّل الدالة toBigDecimal() السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد من النوع java.math.BigDecimal ثم تعيد الناتج. إن لم تكن السلسلة النصية تمثل عددًا، فسيُطلَق الاستثناء NumberFormatException. inline fun String.toBigDecimal(
mathContext: MathContext
): BigDecimal
منصة التشغيل والإصدار المطلوبان: Kotlin 1.2 ، JVM. تحلّل الدالة toBigDecimal() السلسلة النصية التي استٌدعيت معها وتحوّلها إلى ...
الدالة CharSequence.repeat() في Kotlin
تكرِّر الدالة repeat() سلسلة المحارف التي استٌدعيت معها عددًا محددًا من المرات. البنية العامة actual fun CharSequence.repeat(n: Int): String
المعاملات n عدد صحيح يمثل عدد مرات تكرار سلسلة المحارف المعطاة. إن أعطيت قيمة سالبة لهذا المعامل، فسيُطلَق الاستثناء IllegalArgumentException. القيم المعادة تعاد سلسلة من المحارف تحوي جميع محارف السلسلة المعطاة بعد تكرارها n مرة. أمثلة مثالٌ على استعمال الدالة ()repeat: fun main(args: Array<String>) {
println("Word".repeat(4)) // WordWordWordWord
println("Word".repeat(0)) //
}
مثالٌ آخر على استعمال الدالة ()repeat ...
الدالة toHashSet() في Kotlin
تعيد الدالة 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>) {
...
الدالة CharSequence.singleOrNull() في Kotlin
تتحقَّق الدالة singleOrNull() من حواية سلسلة المحارف التي استُدعيت معها محرفًا واحدًا فقط أو محرفًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده، أو تعيد القيمة null خلاف ذلك. البنية العامة fun CharSequence.singleOrNull(): Char?
inline fun CharSequence.singleOrNull(
predicate: (Char) -> Boolean
): Char?
وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات predicate دالة تطبق على كل محرف من محارف السلسلة المعطاة. يمرر إليها محرفٌ وتعيد قيمة منطقية مقابله له. القيم المعادة يعاد المحرف الوحيد الموجود في سلسلة المحارف المعطاة، ...
الدالة Double.compareTo() في Kotlin
توازن الدالة compareTo() بين عدد عشري مضاعف (double) وعدد آخر ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كان العدد الأول (العدد الذي استُدعي مع الدالة) أصغر من العدد الثاني الممرر إليها، أو قيمة موجبة إن كان العدد الأول أكبر من العدد الثاني. استُبدِل بهذه الدالة الدالة Comparable.compareTo(). البنية العامة operator fun compareTo(other: Byte): Int (source)
operator fun compareTo(other: Short): Int (source)
operator fun compareTo(other: Int): Int (source)
operator fun compareTo(other: Long): Int (source)
operator fun compareTo(other: Float): Int (source)
operator fun compareTo(other: Double): ...
الدالة CharSequence.mapNotNull() في Kotlin
تعيد الدالة mapNotNull() قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف السلسلة التي استُدعيت معها باستثناء القيم العدميَّة null التي تعيدها تلك الدالة. البنية العامة inline fun <R : Any> CharSequence.mapNotNull(
transform: (Char) -> R?
): List<R>
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة (inline functions)). المعاملات transform دالةٌ تطبق على كل محرف من محارف السلسلة المعطاة. يمرر إليها محرفٌ وتعيد القيمة المقابلة له. القيم المعادة تُعاد قائمةٌ تضم ناتج تطبيق الدالة transform المعطاة على كل عنصر من ...
الدالة Byte.compareTo() في Kotlin
توازن الدالة compareTo() بين قيمة العنصر الذي استُدعي معها والقيمة المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية. البنية العامة operator fun compareTo(other: Byte): Int
حلت الدالة Comparable.compareTo() مكان الشكل السابق من هذه الدالة. operator fun compareTo(other: Short): Int
operator fun compareTo(other: Int): Int
operator fun compareTo(other: Long): Int
operator fun compareTo(other: Float): Int
operator ...
الدالة withIndex() في Kotlin
تعيد الدالة withIndex() مجموعة تكرارية خاملة (lazy Iterable) من القيم المُفهرسة لكل محرف من محارف السلسلة التي استُدعيت معها. البنية العامة fun CharSequence.withIndex(): Iterable<IndexedValue<Char>>
القيم المعادة تعاد مجموعة تكرارية خاملة (lazy Iterable) من القيم المُفهرسة لكل محرف من محارف السلسلة المعطاة. أمثلة مثالٌ على استعمال الدالة ()withIndex مع سلسلة نصية ثم إسناد الناتج الذي تعيده إلى المتغير iter، لاستخدامه في حلقة تكرارية for: fun main(args: Array<String>) {
val iter = "hsoub".withIndex()
for (x in iter) println(x)
// المخرجات
...
الدالة Float.plus() في Kotlin
تجمع الدالة plus() العدد العشري (float) الذي استُدعي معها مع العدد الممرّر إليها ثم تعيد الناتج. البنية العامة operator fun plus(other: Byte): Float
operator fun plus(other: Short): Float
operator fun plus(other: Int): Float
operator fun plus(other: Long): Float
operator fun plus(other: Float): Float
operator fun plus(other: Double): Double
وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other العدد الآخر الذي ستُجرَى عليه العملية. القيمة المعادة يعاد عدد عشري يحوي ناتج جمع العدد عشري المعطى مع العدد other ...
الدالة last() في Kotlin
تجلب الدالة last() آخر عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها إن لم يمرر إليها أي شيء، أو آخر عنصر يحق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها. إن كانت المصفوفة أو المجموعة التي استُدعيت الدالة first() عبرها فارغة أو لم يكن هناك أي عنصر يحقق الدالة المنطقية الممرَّرة إليها، فستُطلِق الدالة الاستثناءNoSuchElementException. البنية العامة يمكن استدعاء الدالة last() مع المصفوفات بدون تمرير أية معاملات: fun <T> Array<out T>.last(): T
fun ByteArray.last(): Byte
fun ShortArray.last(): Short
fun IntArray.last(): Int
fun LongArray.last(): Long
fun FloatArray.last(): Float
fun DoubleArray.last(): Double
fun BooleanArray.last(): Boolean ...
الصنف Boolean في Kotlin
يمثل الصنف Boolean قيمة منطقية وهي إما true أو false؛ في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثَّل كقيم للنوع boolean الأساسي. class Boolean : Comparable<Boolean>
الدوال and تجري الدالة and() العملية and المنطقية بين قيمتين منطقيتين؛ خلافًا للمعامل &&، تتحقق هذه الدالة من كلا القيمتين المنطقيتين. compareTo توازن الدالة compareTo() بين قيمة العنصر الذي استُدعيت معه والقيمة المُمرّرة إليه ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة ...
الدالة associateTo() في Kotlin
تشبه الدالة associateTo() الدالة associate() تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا. البنية العامة inline fun <T, K, V, M : MutableMap<in K, in V>> Array<out T>.associateTo(
destination: M,
transform: (T) -> Pair<K, V>
): M
inline fun <K, V, M : MutableMap<in K, in V>> ByteArray.associateTo(
destination: M,
transform: (Byte) -> Pair<K, V>
): M
inline fun <K, V, M : MutableMap<in K, in ...
الدالة filterNot() في Kotlin
ترشِّح الدالة filterNot() محارف سلسلة المحارف أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي لم تحقِّق شرطًا معيَّنًا. البنية العامة inline fun CharSequence.filterNot(
predicate: (Char) -> Boolean
): CharSequence
inline fun String.filterNot(
predicate: (Char) -> Boolean
): String
وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (لمزيد من التفاصيل، راجع توثيق الدوال المباشرة). المعاملات predicate دالةٌ تمثل الشرط المراد تطبيقه على كل محرف من محارف سلسلة المحارف أو السلسلة النصية المعطاة. يمرر إلى هذه الدالة محرفٌ وتعيد قيمة منطقية. القيم المعادة ...
الدالة CharSequence.mapNotNullTo() في Kotlin
تشبه الدالة mapNotNullTo() الدالة mapNotNull() تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة. البنية العامة inline fun <R : Any, C : MutableCollection<in R>> CharSequence.mapNotNullTo(
destination: C,
transform: (Char) -> R?
): C
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة (inline functions)). المعاملات destination مجموعة متغيرة تمثل الوجهة التي سيضاف إليها الناتج الذي تعيده الدالة transform. transform دالةٌ تطبق على كل محرف من محارف السلسلة المعطاة. ...
الدالة MatchGroupCollection.get() في Kotlin
تعيد الدالة get() نسخةً من الصنف MatchGroup إن كانت المجموعة التي تحمل الاسم المُمرّر إليها متطابقَة. إن لم يكن جلب المجموعات المتطابقة المُسماة (named groups) مدعومًا، فسيُطلَق الاستثناء UnsupportedOperationException. البنية العامة operator fun MatchGroupCollection.get(
name: String
): MatchGroup?
الإصدار ومنصة التشغيل المطلوبان: JRE8 ،JVM ،Kotlin 1.2 وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). القيم المعادة تعاد نسخة من الصنف MatchGroup إن كانت المجموعة التي تحمل الاسم name متطابقَةأو تعاد القيمة null خلاف ...
الدالة CharSequence.elementAt() في Kotlin
تجلب الدالة elementAt() محرفًا ذي فهرس معيَّن من سلسلة المحارف التي استُدعيت معها. إن كان فهرس المحرف المعطى خارج حدود سلسلة المحارف، فستُطلق الدالة الاستثناءIndexOutOfBoundsException. البنية العامة inline fun CharSequence.elementAt(index: Int): Char
وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (لمزيد من التفاصيل، راجع توثيق الدوال المباشرة). المعاملات index عدد صحيح يمثل فهرس المحرف المراد جلبه من سلسلة المحارف المعطاة. القيم المعادة يُعاد المحرف ذي الفهرس المعطى والموجود ضمن نطاق سلسلة المحارف المعطاة، أو يُطلَق الاستثناء IndexOutOfBoundsException إن كان فهرس العنصر المعطى يقع خارج حدود سلسلة المحارف. أمثلة مثالٌ على استعمال الدالة ...
الدالة replaceIndentByMargin() في Kotlin
تبدِّل الدالة replaceIndentByMargin() سلسلة نصية جديدة مكان المسافة البادئة (indent) المحددة في المعامل الممرر إليها في السلسلة النصية التي استُدعيت معها. البنية العامة fun String.replaceIndentByMargin(
newIndent: String = "",
marginPrefix: String = "|"
): String
المعاملات newIndent السلسلة النصية التي يراد أن تحل مكان المسافة الفارغة البادئة. القيمة الافتراضية هي: "". marginPrefix سلسلة نصية غير فارغة تستعمل كمحدد لحدود المسافة البادئة المراد استبدالها. القيمة الافتراضية هي: | (محرف الأنبوب [pipe character]). القيم المعادة تعاد ...
الدالة Byte.toDouble() في Kotlin
تحول الدالة toDouble() العدد الذي استُدعي معها إلى عدد من النوع Double، وهذا قد يؤدي إلى تقريب العدد. البنية العامة fun toDouble(): Double
القيمة المعادة يعاد عدد من النوع Double. أمثلة تعرّف الشيفرة الآتية عددًا باسم x، ثم تستخدم الدالة()toDouble على x، ثم تطبع الناتج: fun main(args: Array<String>) {
val x: Byte = 52
println(x.toDouble()) // 52.0
}
انظر أيضًا الدالة toByte(): تحوّل العدد الذي استُدعي معها إلى عدد من النوع Byte، وهذا قد يؤدي إلى تقريب العدد أو اقتطاع جزءٍ ...
الدالة isSurrogate() في Kotlin
تتحقق الدالة isSurrogate() إن كان المحرف الذي استٌدعي معها بديلًا لعدد بتات الترميز الموحد (Unicode surrogate code unit). البنية العامة fun Char.isSurrogate(): Boolean
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة المنطقية true إن كان المحرف الذي استٌدعي معها بديلًا لعدد بتات الترميز الموحد، أو القيمة false خلاف ذلك. أمثلة استعمال الدالة isSurrogate() لمعرفة أي المحرفيين التاليين هو بديل لعدد بتات الترميز الموحد: fun main(args: Array<String>) { ...
الدالة find() في Kotlin
تبحث الدالة find() على عنصر محدَّد ضمن عناصر المصفوفة أو المجموعة التي استُدعيت معها ثمَّ تعيد أول ظهور له. البنية العامة inline fun <T> Array<out T>.find(
predicate: (T) -> Boolean
): T?
inline fun ByteArray.find(
predicate: (Byte) -> Boolean
): Byte?
inline fun ShortArray.find(
predicate: (Short) -> Boolean
): Short?
inline fun IntArray.find(predicate: (Int) -> Boolean): Int? (source)
inline fun LongArray.find(
predicate: (Long) -> Boolean
): Long?
inline fun FloatArray.find(
...
الثابت Double.MAX_VALUE في Kotlin
يمثل الثابت Double.MAX_VALUE أكبر قيمة موجبة نهائية (finite) لعدد عشري مضاعف (double). البنية العامة val MAX_VALUE: Double
أمثلة استخدام الثابت Double.MAX_VALUE لمعرفة أكبر عدد عشري مضاعف موجب يمكن استعماله: fun main(args: Array<String>) {
println(Double.MAX_VALUE) // 1.7976931348623157E308
}
انظر أيضًا الثابت Double.MIN_VALUE: يمثل أًصغر قيمة موجبة غير صفرية يمكن أن يأخذها عدد عشري مضاعف (double). الثابت Double.NEGATIVE_INFINITY: يمثل قيمة سالبة لانهائية (infinity) لعدد عشري مضاعف (double). الثابت Double.POSITIVE_INFINITY: يمثل قيمة موجبة لانهائية (infinity) لعدد عشري ...
الدالة filter() في Kotlin
ترشِّح الدالة filter() محارف سلسلة المحارف أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي تحقِّق شرطًا معيَّنًا. البنية العامة inline fun CharSequence.filter(
predicate: (Char) -> Boolean
): CharSequence
inline fun String.filter(
predicate: (Char) -> Boolean
): String
وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (لمزيد من التفاصيل، راجع توثيق الدوال المباشرة). المعاملات predicate دالةٌ تمثل الشرط المراد تطبيقه على كل محرف من محارف السلسلة النصية أو سلسلة المحارف المعطاة. يمرر إلى هذه الدالة محرفٌ وتعيد قيمة منطقية. القيم المعادة تُعاد سلسلة ...
الدالة let() في Kotlin
تستدعي الدالة let() بنية (block) الدالة المُحدَّدة وذلك بجعل قيمة this كوسيط (argument) لها وتعيد ناتج التنفيذ. عادة ما تُُستخدم let()لمنع الوصول إلى المتغيرات في مجال الأسماء (namespace) إذ إنّ كل المتغيرات المعرَّفة داخلها لن تكون متاحةً خارج تلك البنية (block). البنية العامة inline fun <T, R> T.let(block: (T) -> R): R
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions). المعاملات block الكتلة البرمجية المراد استدعاؤها وتنفيذها. القيم المعادة ...
الدالة Regex.findAll() في Kotlin
تبحث الدالة findAll() عن جميع المحارف المتطابقة مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف الممرَّرة إليها. يمكن البحث في سلسلة المحارف المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين. البنية العامة actual fun findAll(
input: CharSequence,
startIndex: Int = 0
): Sequence<MatchResult>
تبحث الدالة findAll() عن جميع المحارف المتطابقة مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف input الممررة إليها. يمكن البحث في سلسلة المحارف المعطاة بأكملها، أو يمكن بدء ...
الدالة Char.toInt() في Kotlin
تحوّل الدالة toInt() المحرف الذي استُدعي معها إلى عدد صحيح (أي من النوع Int). البنية العامة fun toInt(): Int
القيمة المعادة يعاد عدد صحيح من النوع Int يمثل القيمة العددية للمحرف المعطى. أمثلة استعمال الدالة ()toInt لتحويل المحرف 'a' إلى عدد صحيح: fun main(args: Array<String>) {
val x = 'a'
print(x.toInt() ) // 97
}
انظر أيضًا الدالة toByte() : تحوّل المحرف الذي استُدعي معها إلى عدد من ...
الدالة take() في Kotlin
تجلب الدالة 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 عدد صحيح يمثل عدد العناصر الأولى المراد جلبها من المصفوفة أو المجموعة التكرارية المعطاة. إن كانت القيمة المعطاة لهذا المعامل ...
الدالة Double.div() في Kotlin
تقسِّم الدالة div() العدد العشري المضاعف (double) الذي استُدعي معها على العدد الممرّر إليها ثم تعيد الناتج. البنية العامة operator fun div(other: Byte): Double
operator fun div(other: Short): Double
operator fun div(other: Int): Double
operator fun div(other: Long): Double
operator fun div(other: Float): Double
operator fun div(other: Double): Double
وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other العدد الآخر الذي ستجرى عليه العملية. القيمة المعادة يعاد عدد عشري مضاعف ناتج قسمة العدد العدد العشري المضاعف المعطى على العدد other ...
الدالة flatMapTo() في Kotlin
تشبه الدالة flatMapTo() الدالة flatMap() تمامًا باستثناء أنها تضيف الناتج المعاد إلى كائن موجود مسبقًا بدلًا من إعادته فقط. البنية العامة يمكن استدعاء الدالة flatMapTo() مع المصفوفات: inline fun <T, R, C : MutableCollection<in R>> Array<out T>.flatMapTo(
destination: C,
transform: (T) -> Iterable<R>
): C
inline fun <R, C : MutableCollection<in R>> ByteArray.flatMapTo(
destination: C,
transform: (Byte) -> Iterable<R>
): C
inline fun <R, C : MutableCollection<in R>> ShortArray.flatMapTo(
...
الدالة filterNotTo() في Kotlin
تشبه الدالة filterNotTo() الدالة filterNot() تمامًا باستثناء أنها تضيف الناتج إلى كائن موجود مسبقًا بدلًا من أن تعيده. البنية العامة inline fun <C> CharSequence.filterNotTo(
destination: C,
predicate: (Char) -> Boolean
): C
وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (لمزيد من التفاصيل، راجع توثيق الدوال المباشرة). المعاملات destination كائن موجود مسبقًا يمثل الوجهة المراد إضافة الناتج فيها. predicate دالةٌ تمثل الشرط المراد تطبيقه على كل محرف من محارف سلسلة المحارف المعطاة. يمرر إلى هذه الدالة محرفٌ ...
الدالة xor() في Kotlin
تجري الدالة xor() العملية xor المنطقية بين قيمتين منطقيتين. البنية العامة infix fun xor(other: Boolean): Boolean
وجود الكلمة المفتاحية infix يدل على أنَّ هذه الدالة يمكن استدعاؤها بنمط التدوين الداخليّ (infix notation)؛ أي من خلال حذف المعامل . والأقواس () المُستخدَمَين في الاستدعاء عادةً. المعاملات other القيمة المنطقية الأخرى التي ستطبق عليها العملية. القيمة المعادة تعاد قيمة منطقية تكون ناتج إجراء العملية xor على القيمتين المعطيتين. أمثلة استخدام الدالة ()xor لتطبيق العملية xor على قيمتين منطقيتين: fun main(args: Array<String>) {
println(true xor false) // ...
الدالة replaceIndent() في Kotlin
تبدِّل الدالة replaceIndent() سلسلة نصية جديدة مكان المسافة البادئة الفارغة (indent) في السلسلة النصية التي استُدعيت معها. البنية العامة fun String.replaceIndent(newIndent: String = ""): String
المعاملات newIndent السلسلة النصية التي يراد أن تحل مكان المسافة الفارغة البادئة. القيمة الافتراضية هي: "". القيم المعادة تعاد سلسلة نصية تحوي جميع محارف السلسلة النصية المعطاة بعد تبديل قيمة المعامل newIndent مكان المسافة البادئة الفارغة فيها. أمثلة مثالٌ على استعمال الدالة ()replaceIndent: fun main(args: Array<String>) {
val str = " ...
الدالة CharSequence.mapIndexed() في Kotlin
تعيد الدالة mapIndexed() قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف السلسلة التي استُدعيت معها. البنية العامة inline fun <R> CharSequence.mapIndexed(
transform: (index: Int, Char) -> R
): List<R>
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة (inline functions)). المعاملات transform دالةٌ تطبق على كل محرف من محارف السلسلة المعطاة. يمرر إليها فهرس المحرف وقيمته وتعيد القيمة المقابلة لهذا المحرف. القيم المعادة تُعاد قائمةٌ تضم ناتج تطبيق الدالة transform المُمرّرة على فهرس وقيمة كل ...
الدالة mapIndexedNotNull() في Kotlin
تعيد الدالة mapIndexedNotNull() قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء القيم العدميَّة null التي تعيدها تلك الدالة. البنية العامة يمكن استدعاء الدالةmapIndexedNotNull() مع المصفوفات والمجموعات: inline fun <T, R : Any> Array<out T>.mapIndexedNotNull(
transform: (index: Int, T) -> R?
): List<R>
inline fun <T, R : Any> Iterable<T>.mapIndexedNotNull(
transform: (index: Int, T) -> R?
): List<R>
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة ...
الدالة Char.inc() في Kotlin
تعيد الدالة inc() المحرف اللاحق للمحرف الذي استُدعيت معه. البنية العامة operator fun inc(): Char
وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). القيمة المعادة يعاد المحرف اللاحق للمحرف المعطى. أمثلة استعمال الدالة ()dec لجلب الحرف الذي يلي الحرف 'W': fun main(args: Array<String>) {
val x = 'W'
println(x.inc()) // X
}
انظر أيضًا الدالة compareTo(): توازن بين قيمة العنصر الذي استُدعيت معه والقيمة ...
الدالة filterNotTo() في Kotlin
تشبه الدالة filterNotTo() الدالة filterNot() في جميع النواحي باستثناء أنَّها تضيف الناتج المعاد إلى المعامل الممرَّر إليها. الجدير بالذكر أنّه ينبغي أن يكون ذلك المعامل المعطى مجموعةً قابلةً للتغيير (MutableCollection) إن استدعيت الدالة مع مصفوفة أو مجموعة، أو خريطةً قابلة للتغيير (MutableMap) إن استدعيت الدالة مع خريطة. البنية العامة يمكن استدعاء الدالة filterNotTo() مع المصفوفات أو المجموعات: inline fun <T, C : MutableCollection<in T>> Array<out T>.filterNotTo(
destination: C,
predicate: (T) -> Boolean
): C
inline ...
الدالة withIndex() في Kotlin
تعيد الدالة withIndex() مجموعة تكرارية خاملة (lazy Iterable) من القيم المُفهرسة لكل عنصر من عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها، أو تعيد مُكرّرًا (iterator) يغلّف كل عنصر أنتجه المكرّر (Iterator) المستدعى مع الدالة مع القيمة المُفهرسة أي يعيد القيمة مع فهرسها. البنية العامة يمكن استدعاء الدالة withIndex() مع المصفوفات أو المجموعات التكرارية أو المكرِّرات: fun <T> Array<out T>.withIndex(): Iterable<IndexedValue<T>>
fun ByteArray.withIndex(): Iterable<IndexedValue<Byte>>
fun ShortArray.withIndex(): Iterable<IndexedValue<Short>>
fun IntArray.withIndex(): Iterable<IndexedValue<Int>>
fun LongArray.withIndex(): Iterable<IndexedValue<Long>>
fun FloatArray.withIndex(): Iterable<IndexedValue<Float>>
fun DoubleArray.withIndex(): Iterable<IndexedValue<Double>>
fun BooleanArray.withIndex(): Iterable<IndexedValue<Boolean>>
fun ...
الدالة Float.compareTo() في Kotlin
توازن الدالة compareTo() بين عدد عشري (float) وعدد آخر ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كان العدد الأول (العدد الذي استُدعي مع الدالة) أصغر من العدد الثاني الممرر إليها، أو قيمة موجبة إن كان العدد الأول أكبر من العدد الثاني. البنية العامة operator fun compareTo(other: Byte): Int
operator fun compareTo(other: Short): Int
operator fun compareTo(other: Int): Int
operator fun compareTo(other: Long): Int
operator fun compareTo(other: Float): Int
حلت الدالة Comparable.compareTo() مكان الأشكال السابقة من هذه الدالة. operator ...
الدالة Double.unaryPlus() في Kotlin
تعيد الدالة unaryPlus() العدد العشري المضاعف (double) الذي استُدعي معها. البنية العامة operator fun unaryPlus(): Double
وجود الكلمة المفتاحيّة operator يدل على أنّ هذه الدالة مرتبطٌة بمعامل تكرار (iteration operator). القيمة المعادة يعاد العدد نفسه المعطى. أمثلة استعمال الدالة ()unaryPlus لإعادة القيمة المستدعاة معها: fun main(args: Array<String>) {
val x: Double = 52.54
println(x.unaryPlus()) // 52.54
}
انظر أيضًا الدالة unaryMinus(): تعيد القيمة السالبة المقابلة للعدد العشري المضاعف (double) الذي استُدعي معها. الدالة inc() : تزيد العدد العشري المضاعف (double) ...
الدالة isHighSurrogate() في Kotlin
تتحقق الدالة isHighSurrogate() إن كان المحرف الذي استٌدعي معها بديلًا علويًا لعدد بتات الترميز الموحد (Unicode high-surrogate code unit). البنية العامة inline actual fun Char.isHighSurrogate(): Boolean
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كان المحرف المعطى بديلًا علويًا لعدد بتات الترميز الموحد، أو القيمة false خلاف ذلك. أمثلة مثالٌ على استعمال الدالة isHighSurrogate(): fun main(args: Array<String>) {
val x = 'a'
val y ...
الدالة Float.unaryPlus() في Kotlin
تعيد الدالة unaryPlus() العدد العشري (float) الذي استُدعي معها. البنية العامة operator fun unaryPlus(): Float
وجود الكلمة المفتاحيّة operator يدل على أنّ هذه الدالة مرتبطٌة بمعامل تكرار (iteration operator). القيمة المعادة يعاد العدد نفسه المعطى. أمثلة استعمال الدالة ()unaryPlus لإعادة القيمة المستدعاة معها: fun main(args: Array<String>) {
val x: Float = 52.54f
println(x.unaryPlus()) // 52.54
}
انظر أيضًا الدالة unaryMinus(): تعيد القيمة السالبة المقابلة للعدد العشري (float) الذي استُدعي معها. الدالة inc() : تزيد العدد العشري (float) الذي استُدعي معها ...
الدالة reversed() في Kotlin
تُعيد الدالة reversed() قائمة تضم عناصر المصفوفة أو المجموعة التي استُدعيت معها بترتيب معكوس. البنية العامة fun <T> Array<out T>.reversed(): List<T>
fun ByteArray.reversed(): List<Byte>
fun ShortArray.reversed(): List<Short>
fun IntArray.reversed(): List<Int>
fun LongArray.reversed(): List<Long>
fun FloatArray.reversed(): List<Float>
fun DoubleArray.reversed(): List<Double>
fun BooleanArray.reversed(): List<Boolean>
fun CharArray.reversed(): List<Char>
fun <T> Iterable<T>.reversed(): List<T>
القيم المعادة تعاد قائمة تضم عناصر المصفوفة أو المجموعة المعطاة بترتيب معكوس. أمثلة استعمال الدالة ()reversed لعكس ترتيب عناصر قائمة: fun main(args: Array<String>) {
var list = listOf(1, 2, 3, ...
الدالة Float.toChar() في Kotlin
تحول الدالة toChar() العدد العشري (float) الذي استُدعي معها إلى المحرف الذي يقابله (أي من النوع Char) بعد اقتطاعه إلى 16 بت إن تطلب ذلك. البنية العامة fun toChar(): Char
حلت الدالة Number.toChar() مكان هذه الدالة. القيمة المعادة يعاد المحرف الذي تساوي قيمته العددية العدد العشري المعطى. أمثلة استعمال الدالة ()toChar لتحويل عدة أعداد عشرية إلى ما يقابلها من محارف: fun main(args: Array<String>) {
val x: Float = 97.4f
val y: Float = 50.2f
...
الدالة CharSequence.maxWith() في Kotlin
تجلب الدالة maxWith() المحرف الأول من سلسلة المحارف التي استُدعيت معها والذي له أكبر قيمة بحسب الموازن comparator المعطى. البنية العامة fun CharSequence.maxWith(
comparator: Comparator<in Char>
): Char?
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات comparator دالةٌ تمثل الموزان الذي سيُطبَّق على كل محرف من محارف السلسلة المعطاة. القيم المعادة يُعاد المحرف الأول من سلسلة المحارف المعطاة والذي له أكبر قيمة بحسب الدالة comparator الموازنة المعطاة، أو القيمة null إن لم يكن هنالك أي عنصر. أمثلة مثال عن استعمال الدالة ...
الدالة isEmpty() في Kotlin
تتحقق الدالة isEmpty() إن كانت سلسلة المحارف التي استٌدعيت معها فارغةً. البنية العامة inline fun CharSequence.isEmpty(): Boolean
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كانت سلسلة المحارف التي استٌدعيت معها فارغةً، أو القيمة false خلاف ذلك. أمثلة مثالٌ على استعمال الدالة isEmpty(): fun main(args: Array<String>) {
print("hsoub".isEmpty()) // false
print(" ".isEmpty()) // false
...
الدالة CharSequence.hasSurrogatePairAt() في Kotlin
تتحقق الدالة hasSurrogatePairAt() إن كان لدى سلسلة المحارف التي استُدعيت معها زوجًا بديلًا في الترميز الموحد (Unicode surrogate pair) للمحرف ذي الفهرس المُحدّد. البنية العامة fun CharSequence.hasSurrogatePairAt(index: Int): Boolean
المعاملات index عدد صحيح يمثل فهرس المحرف الذي سيُتحقَق منه. القيم المعادة تعاد القيمة true إن كان لدى سلسلة المحارف التي استُدعيت معها زوجًا بديلًا في الترميز الموحد (Unicode surrogate pair) عند الفهرس index، أو تعاد القيمة false خلاف ذلك. أمثلة مثالٌ على استعمال الدالة ()hasSurrogatePairAt: fun main(args: Array<String>) {
...
عرض (500 السابقة | 500 التالية) (20 | 50 | 100 | 250 | 500).