نتائج البحث
اذهب إلى التنقل
اذهب إلى البحث
الدالة Appendable.append() في Kotlin
تضيف الدالة append() المحرف الممرر إليها أو كامل محتوى الكائن المُمرّر إليها أو جزءًا منه إلى الكائن المستدعى معها. البنية العامة abstract actual fun append(csq: CharSequence?): Appendable
abstract actual fun append(
csq: CharSequence?,
start: Int,
end: Int
): Appendable
abstract actual fun append(c: Char): Appendable
بيئة التشغيل المطلوبة: JS. المعاملات csq سلسلة من المحارف التي يراد إضافتها بأكملها أو جزء محدد منها إلى الكائن المعطى. start عدد صحيح يحدد فهرس المحرف الذي يمثل بداية ...
الدالة DoubleArray.iterator() في Kotlin
تنشئ الدالة iterator() عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. البنية العامة operator fun iterator(): DoubleIterator
وجود الكلمة المفتاحية operator يدل على أنّ هذه الدالة مرتبطٌ بمعامل تكرار (iteration operator، اطلع على المثال في الأسفل). القيم المعادة يعاد عنصرٌ تكراريٌٌ (iterator) من أجل تكرار بنيةٍ (block) برمجيةٍ معينة على كافّة عناصر المصفوفة المعطاة. أمثلة استعمال الدالة iterator() لتخصيص عنصر تكراري من أجل استخدامه في الحلقة for التكرارية التي تطبع قيم جميع العناصر: fun main(args: Array<String>) {
val f: (Int) -> ...
الصنف CharCategory في Kotlin
الدوال الموروثة clone يطلق التابع clone() استثناءً (exception) لأنّ ثوابت enum لا يمكن أن تُنسخ. هذا التابع يمنع الأصناف من النوع Enum من أن ترِث من الصنفCloneable. compareTo تقارن الدالةcompareTo() بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة 0 إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة . equals تبين الدالة equals() إذا ما كان الكائن المُمرّر إليها يساوي ...
الدالة trimMargin() في Kotlin
تحذف الدالة trimMargin() جميع المحارف البيضاء البادئة المتبوعة بقيمة محددة من جميع أسطر السلسلة النصية التي استُدعيت معها، كما تحذف السطر الأول والأخير إن كانا فارغين (blanks)؛ أي مُكوّنان من مسافات بيضاء (whitespaces). لا تؤثر الدالةُ على الاسطر التي لا تحوي القيمة المحددة بالمعامل marginPrefix المعطى، باستثناء الأسطر البيضاء الأولى والأخيرة. البنية العامة fun String.trimMargin(marginPrefix: String = "|"): String
المعاملات marginPrefix سلسلة نصية غير فارغة -أي لا تحوي أية مسافة بيضاة- تستعمل كمحدد للهامش المراد حذفه. القيمة الافتراضية هي: | ...
الدالة filterIsInstance() في Kotlin
تعيد الدالة filterIsInstance() قائمة تحوي عناصر المصفوفة أو المجموعة المعطاة التي هي نسخةٌ (instance) من نوع أو صنفٍ معيّن. البنية العامة inline fun <reified R> Array<*>.filterIsInstance(): List<R>
inline fun <reified R> Iterable<*>.filterIsInstance(): List<R>
يمكن تمرير المعامل klass إلى الدالة filterIsInstance(): fun <R> Array<*>.filterIsInstance(klass: Class<R>): List<R>
fun <R> Iterable<*>.filterIsInstance(klass: Class<R>): List<R>
بيئة التشغيل المطلوبة: JVM وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (لمزيد من التفاصيل، راجع توثيق الدوال المباشرة)، واستخدام الكلمة المفتاحية reified يسمح بالوصول إلى نوعٍ مُمرَّر كمتحولٍ وسيطٍ (parameter، راجع توثيق reified ...
الدالة replaceAfter() في Kotlin
تبدِّل الدالة replaceAfter() سلسلة نصية مكان كل الجزء الواقع بعد أول ظهور لمحرف أو لسلسلة نصية معينة في سلسلة نصية. البنية العامة fun String.replaceAfter(
delimiter: Char,
replacement: String,
missingDelimiterValue: String = this
): String
fun String.replaceAfter(
delimiter: String,
replacement: String,
missingDelimiterValue: String = this
): String
المعاملات delimiter المحرف أو السلسلة النصية التي يراد استبدال كامل الجزء الواقع بعدها. replacement ...
الدالة joinToString() في Kotlin
تضيف الدالة joinToString() بادئة ولاحقة إلى جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها (أو جزءٍ منها) بعد فصل عناصرها بفاصلة معينة ثمَّ تضع الناتج في سلسة نصية جديدة تنشئها آنذاك. إن كانت المجموعة كبيرة، فيمكن تحديد جزءٍ أولي معين منها فقط لإضافته إلى السلسلة النصية؛ في هذه الحالة، تضاف سلسلة نصية معيَّنة، مثل "..." أو "...إلخ" إلى السلسلة النصية الناتجة للدلالة على وجود جزءٍ مقتطعٍ. البنية العامة fun <T> Array<out T>.joinToString(
separator: CharSequence = ", ", ...
الدالة CharSequence.sumByDouble() في Kotlin
تجمع الدالة sumByDouble() جميع نواتج تطبيق دالة معيَّنة على كل محرف من محارف سلسلة المحارف التي استُدعيت معها. الفرق بين الدالة sumByDouble() والدالة sumBy() هو في نوع القيمة التي تستطيع الدالة الممرَّر إلى كلٍّ منهما إعادتها، إذ تعيد الدالة المُمرَّرة إلى sumBy() عددًّا صحيحًا (integer) بينما يمكن أن تعيد الدالة الممررة إلى sumByDouble() عددًا عشريًّا مضاعفًا (double). البنية العامة inline fun CharSequence.sumByDouble(
selector: (Char) -> Double
): Double
يُلاحَظ وجود الكلمة المفتاحية inline التي تدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). المعاملات selector الدالة التي ...
الدالة CharSequence.forEachIndexed() في Kotlin
تُنفّد الدالةُ forEachIndexed() الدالةَ المُمرّرةَ إليها على كل محرف من محارف السلسلة التي استُدعيت معها وعلى فهرس ذلك المحرف. البنية العامة inline fun CharSequence.forEachIndexed(
action: (index: Int, Char) -> Unit)
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات action الدالة المراد تنفيذها مع كل محرف من محارف السلسلة المعطاة. يمرر إليها فهرس المحرف index وقيمته Char. أمثلة مثالٌ على استعمال الدالة ()forEachIndexed: fun main(args: Array<String>) {
val str = "Hsoubwiki"
...
الدالة removeRange() في Kotlin
تحذف الدالة removeRange() مجالًا محددًا من سلسلة المحارف أو السلسلة النصية التي استٌدعيت معها. البنية العامة fun CharSequence.removeRange(
startIndex: Int,
endIndex: Int
): CharSequence
inline fun String.removeRange(
startIndex: Int,
endIndex: Int
): String
fun CharSequence.removeRange(range: IntRange): CharSequence
inline fun String.removeRange(range: IntRange): String
المعاملات startIndex عدد صحيح يشير إلى فهرس المحرف الذي يمثل بداية الجزء المراد حذفه. endIndex عدد صحيح يشير إلى فهرس المحرف الذي يمثل نهاية الجزء المراد حذفه (لا ...
الدالة asDynamic() في Kotlin
تعيد الدالة asDynamic() قيمة الكائن الذي استدعيت عبره على شكل قيمةٍ من النوع الديناميكي (dynamic type)، الذي يُسمَح بإسناده إلى أي متغيّر أو تمريره كمتغيّر وسيط (argument) أيًّا كان نوعه. بيئة التشغيل المطلوبة: JS البنية العامة inline fun Any?.asDynamic(): dynamic
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions). القيم المعادة تعاد قيمة من النوع الديناميكي (dynamic type). انظر أيضًا الدوال المباشرة (inline functions) في لغة Kotlin. مصادر صفحة الدالة ...
الدالة isNotEmpty() في Kotlin
تتحقق الدالة isNotEmpty() إن كانت سلسلة المحارف التي استٌدعيت معها غير فارغة. البنية العامة inline fun CharSequence.isNotEmpty(): Boolean
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كانت سلسلة المحارف المعطاة غير فارغة، أو القيمة false خلاف ذلك. أمثلة مثالٌ على استعمال الدالة isNotEmpty(): fun main(args: Array<String>) {
print("hsoub".isNotEmpty()) // true
print(" ".isNotEmpty()) // true
...
الخاصية MatchGroup.range في Kotlin
تمثل الخاصية MatchGroup.range مجال الفهارس التي تحدّد مكان مجموعة النتائج التي تم الحصول عليها. البنية العامة val range: IntRange
المنصة المطلوبة: JVM. القيم المعادة يعاد مجال الفهارس التي تحدّد مكان مجموعة النتائج التي تم الحصول عليها. انظر أيضًا الخاصية MatchGroup.value: تمثل قيمة مجموعة النتائج التي تم الحصول عليها. مصادر صفحة الخاصيّة MatchGroup.range في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.
الدالة map() في Kotlin
تعيد الدالة map() قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل عنصر من عناصر المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها. البنية العامة يمكن استدعاء الدالة map() مع المصفوفات والمجموعات والخرائط: inline fun <T, R> Array<out T>.map(
transform: (T) -> R
): List<R>
inline fun <R> ByteArray.map(transform: (Byte) -> R): List<R>
inline fun <R> ShortArray.map(
transform: (Short) -> R
): List<R>
inline fun <R> IntArray.map(transform: (Int) -> R): List<R>
inline fun <R> LongArray.map(transform: (Long) ...
الصنف CharDirectionality في Kotlin
الخاصيات الموروثة (Inherited Properties) name تعيد الخاصية name اسم الثابت من الكائن enum الذي استُدعيت عبره، كما سُمّيت أُثناء تعريف ذلك الكائن. ordinal تعيد الخاصية ordinal ترتيب الثابت من الكائن enum الذي استُدعيت عبره enumeration constant))، أي ترتيبها في تصريح الكائن enum،بحيث تأخذ المُركّبة الأولى العدد 0. الدوال الموروثة clone يطلق التابع clone() استثناءً (exception) لأنّ ثوابت enum لا يمكن أن تُنسخ. هذا التابع يمنع الأصناف من النوع Enum من أن ترِث من الصنفCloneable. compareTo تقارن الدالةcompareTo() بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة 0 إن كانا متساويين، أو تعيد قيمة سلبية ...
الدالة CharSequence.lastIndexOf() في Kotlin
تجلب الدالة lastIndexOf() فهرس آخر ظهور لمحرف أو سلسلة نصية محدَّدة من سلسلة المحارف التي استُدعيت معها. البنية العامة fun CharSequence.indexOf(
char: Char,
startIndex: Int = 0,
ignoreCase: Boolean = false
): Int
fun CharSequence.indexOf(
string: String,
startIndex: Int = 0,
ignoreCase: Boolean = false
): Int
المعاملات char المحرف المراد البحث عنه ضمن سلسلة من المحارف. startIndex السلسلة النصية المراد البحث عنها ضمن سلسلة ...
الدالة StringBuilder.reverse() في Kotlin
تعكس الدالة reverse() ترتيب محارف الكائن StringBuilder. البنية العامة actual fun reverse(): StringBuilder
منصة التشغيل المطلوبة: JS. القيمة المعادة يعاد الكائن StringBuilder نفسه المعطى بعد عكس ترتيب محارفه. أمثلة استعمال الدالة reverse() لعكس ترتيب محارف كائن من النوع StringBuilder: fun main(args: Array<String>) {
val sb = StringBuilder("hsoub")
println(sb.reverse()) // => buosh
}
انظر أيضًا الدالة append(): تضيف محرفًا أو سلسلة نصية أو أيَّ كائن آخر إلى الكائن StringBuilder. الدالة toString(): تحول الكائن StringBuilder إلى ...
الدالة drop() في Kotlin
تُزيِل الدالة drop() أول n محرف من محارف السلسلة النصية أو سلسلة المحارف التي استُدعيت معها. البنية العامة fun CharSequence.drop(n: Int): CharSequence
fun String.drop(n: Int): String
المعاملات n عدد صحيح يمثل عدد المحارف المراد حذفها من بداية السلسلة النصية. القيم المعادة تعاد سلسلة نصية أو سلسلة من المحارف تحوي جميع محارف السلسلة النصية أو سلسلة المحارف المعطاة باستثناء أول n محرف. أمثلة مثالٌ عن استعمال الدالة ()drop: fun main(args: Array<String>) {
val str = "wiki Hsoub"
println(str.drop(0)) // wiki Hsoub
...
الدالة also() في Kotlin
تستدعي الدالة also() بُنية (block) الدالة المُحدَّدة مع جعل قيمة this كوسيط (argument) وتُعيد قيمة this. البنية العامة inline fun <T> T.also(block: (T) -> Unit): T
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions)). المعاملات block الكتلة البرمجية المراد استدعاؤها وتنفيذها. القيم المعادة تعيد الكائن الذي استدعيت عبره بعد التعديل عليه. أمثلة استخدام الدالة also() مع الكائنات لتعديل خاصياتها (properties) تستدعي الشيفرة الآتية الدالة also() عبر السلسلة النصية string ...
الثابت Double.POSITIVE_INFINITY في Kotlin
يمثل الثابت Double.POSITIVE_INFINITY قيمة موجبة لا نهائية (infinity) لعدد عشري مضاعف (double). البنية العامة val POSITIVE_INFINITY: Double
أمثلة استخدام الثابت Double.POSITIVE_INFINITY لطباعة قيمة موجبة لا نهائية لعدد عشري مضاعف: fun main(args: Array<String>) {
println(Double.POSITIVE_INFINITY ) // Infinity
}
انظر أيضًا الثابت Double.MAX_VALUE: يمثل أكبر قيمة موجبة نهائية (finite) لعدد عشري مضاعف (double). الثابت Double.MIN_VALUE: يمثل أًصغر قيمة موجبة غير صفرية يمكن أن يأخذها عدد عشري مضاعف (double). الثابت Double.NEGATIVE_INFINITY: يمثل قيمة سالبة لا نهائية ...
الدالة plus() في Kotlin
تضيف الدالة plus() المحرف الذي استٌدعي معها إلى بداية السلسلة النصية المُمرّرة إليها. البنية العامة inline operator fun Char.plus(other: String): String
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). يدل أيضًا وجود الكلمة المفتاحيّة operator على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other السلسلة النصية الأخرى التي سيضاف إليها المحرف المعطى. القيم المعادة تعاد السلسلة النصية other بعد إضافة المحرف المعطى إلى بدايتها. أمثلة استعمال الدالة plus() لإضافة ...
الدالة Float.div() في Kotlin
تقسِّم الدالة div() العدد العشري (float) الذي استُدعي معها على العدد المُمرّر إليها ثمَّ تعيد الناتج. البنية العامة operator fun div(other: Byte): Float
operator fun div(other: Short): Float
operator fun div(other: Int): Float
operator fun div(other: Long): Float
operator fun div(other: Float): Float
operator fun div(other: Double): Double
وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other العدد الآخر الذي ستُجرَى عليه العملية. القيمة المعادة يعاد عدد عشري ناتج قسمة العدد العدد العشري المعطى على العدد other الممرّر. إن ...
الخاصية Char.directionality في Kotlin
تعيد الخاصية Char.directionality قيمة اتجاهية اليونيكود (Unicode directionality) للمحرف الذي استُدعيت معه. البنية العامة val Char.directionality: CharDirectionality
المنصة المطلوبة: JVM. القيم المعادة تعاد قيمة اتجاهية اليونيكود للمحرف المعطى. مثال استعمال الخاصية directionality لمعرفة اتجاهية عدة محارف: fun main(args: Array<String>) {
val x = 'a'
val y = 'أ'
val z = '4'
println(x.directionality) // LEFT_TO_RIGHT
println(y.directionality) // RIGHT_TO_LEFT_ARABIC
println(z.directionality) // EUROPEAN_NUMBER
}
انظر أيضًا ...
الدالة flatten() في Kotlin
تعيد الدالة flatten() قائمة واحدة تحوي جميع عناصر المصفوفات أو المجموعات المتشعبة ضمن المصفوفة أو المجموعة التي استُدعيت معها. البنية العامة يمكن استدعاء الدالة flatten() مع المصفوفات: fun <T> Array<out Array<out T>>.flatten(): List<T>
ويمكن استدعاؤها مع المجموعات: fun <T> Iterable<Iterable<T>>.flatten(): List<T>
القيم المعادة تُعاد قائمة واحدة تحوي جميع عناصر المصفوفات أو المجموعات المتشعبة ضمن المصفوفة أو المجموعة المعطاة. أمثلة استخدام الدالة ()flatten مع المصفوفات: fun main(args: Array<String>) {
val deepArray = arrayOf(
...
الدالة CharSequence.associateBy() في Kotlin
تعيد الدالة associateBy() خريطةً (map) مكونة من الأزواج "مفتاح/قيمة"، إذ يكون المفتاح (key) هو الناتج الذي تعيده الدالة keySelector الممررة إليها وتكون القيمة (value) المقابلة لذلك المفتاح هي إمَّا محارف سلسلة المحارف المعطاة أو الناتج الذي تعيده الدالة valueTransform الممررة. إن كان لزوجين نفس المفتاح (key)، فالأخير هو الذي سيُضاف إلى الخريطة. تحافظ الخريطة المُعادة على نفس ترتيب التكرار الخاص بسلسلة المحارف الأصليَّة. البنية العامة inline fun <K> CharSequence.associateBy(
keySelector: (Char) -> K
): Map<K, Char>
inline fun <K, V> CharSequence.associateBy(
...
الدالة CharSequence.lastOrNull() في Kotlin
تجلب الدالة lastOrNull() آخر محرف من محارف السلسلة التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو آخر عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها. إن كانت سلسلة المحارف التي استُدعيت الدالة lastOrNull() معها فارغةً أو لم يكن هناك أي عنصر يحقق الدالة المنطقية الممرَّرة إليها، فستعيد الدالة القيمة null. البنية العامة fun CharSequence.lastOrNull(): Char?
inline fun CharSequence.lastOrNull(
predicate: (Char) -> Boolean
): Char?
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات predicate دالةٌ تمثل الشرط المراد ...
الدالة CharSequence.foldIndexed() في Kotlin
تجمِّع الدالة foldIndexed() تراكميًّا ناتج تطبيق عملية معينة على فهرس كل محرف من محارف السلسلة المستدعاة معها (من اليسار إلى اليمين) وقيمته والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت. البنية العامة inline fun <R> CharSequence.foldIndexed(
initial: R,
operation: (index: Int, acc: R, Char) -> R
): R (source)
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات initial قيمة أولية يراد إضافتها مع ناتج تطبيق الدالة operation على أول ...
الخاصية indices في Kotlin
تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (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)
...
الدالة toMap() في Kotlin
تحول الدالة 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() مع مصفوفة أو مجموعة تكرارية أو سلسلة ...
الدالة Float.inc() في Kotlin
تزيد الدالة inc() العدد العشري (float) الذي استُدعي معها بمقدار 1 ثمَّ تعيد القيمة الناتجة. البنية العامة operator fun inc(): Float
وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). القيمة المعادة تعاد قيمة من النوع Float تمثل القيمة المعطاة بعد زيادتها بمقدار 1. أمثلة استعمال الدالة ()dec لزيادة عدد عشري بمقدار 1 فقط: fun main(args: Array<String>) {
val x: Float = 5.54f
println(x.inc()) // 6.54
}
انظر أيضًا ...
الدالة FloatArray.iterator() في Kotlin
ينشئ الدالة iterator() عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. البنية العامة operator fun iterator(): FloatIterator
وجود الكلمة المفتاحية operator يدل على أنّ هذه الدالة مرتبطٌ بمعامل تكرار (iteration operator، اطلع على المثال في الأسفل). القيم المعادة يعاد عنصرٌ تكراريٌٌ (iterator) من أجل تكرار بنيةٍ (block) برمجيةٍ معينة على كافّة عناصر المصفوفة المعطاة. أمثلة استعمال الدالة iterator() لتخصيص عنصر تكراري من أجل استخدامه في الحلقة for التكرارية التي تطبع قيم جميع العناصر: fun main(args: Array<String>) {
val f: (Int) -> ...
الدالة first() في Kotlin
تجلب الدالة first() أول عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها إن لم يمرر إليها أي شيء، أو أول عنصر يحق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها. إن كانت المصفوفة أو المجموعة التي استُدعيت الدالة first() عبرها فارغة أو لم يكن هناك أي عنصر يحقق الدالة المنطقية الممرَّرة إليها، فستُطلِق الدالة الاستثناء NoSuchElementException. البنية العامة يمكن استدعاء الدالة first() بدون تمرير أية معاملات: fun <T> Array<out T>.first(): T
fun ByteArray.first(): Byte
fun ShortArray.first(): Short
fun IntArray.first(): ...
الصنف DeprecationLevel في Kotlin
يحوي الصنف DeprecationLevel مستويات تصف درجات الإهمال (deprecation levels). enum class DeprecationLevel
القيم القابلة للعد (Enum Values) WARNING تشير القيمة WARNING إلى وجود تحذير تولد نتيجة استعمال عنصر مهمل (deprecated element). ERROR تشير القيمة ERROR إلى وجود خطأٍ تولد نتيجة استعمال عنصر مهمل (deprecated element). HIDDEN تشير القيمة HIDDEN إلى أن العنصر المهمل (deprecated elements) غير متاح للاستخدام ضمن الشيفرة. الخاصيات الموروثة (Inherited Properties) name تمثِّل الخاصية Enum.name اسم الثابت المعرف في الكائن enum الذي استُدعي معها كما سُمّي أُثناء تعريف هذا الكائن. ordinal تمثل الخاصية Enum.ordinal ترتيب (ordinal) الثابت المعرف في ...
الواجهة Appendable في Kotlin
actual typealias Appendable = Appendable
المنصة والإصدار المطلوبان: Kotlin 1.1، JVM. actual interface Appendable
المنصة المطلوبة: JS. الدوال append تضيف هذه الدالة المحرف الممرر إليها أو كامل محتوى الكائن المُمرّر إليها أو جزءًا منه إلى الكائن المستدعى معها. الدوال الموروثة equals تتحقق هذه الدالة إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعي معها. hashCode تعيد هذه الدالة الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. toString تحول هذه الدالة الكائن الذي يُستدعى معه إلى سلسلة نصية (String). مصادر صفحة الواجهة Appendable في التوثيق ...
الخاصية MatchResult.destructured في Kotlin
تمثل الخاصية MatchResult.destructured نسخةً من الصنف Destructured توفّر مكونات عملية الإسناد بالتفكيك (destructuring assignment) التي تطبق على قيم المجموعة المُطابقة. تطابق الدالة component1 قيمة المجموعة الأولى، وتطابق الدالة component2 قيمة المجموعة الثانية، وهلم جرًا. البنية العامة open val destructured: Destructured
القيمة المعادة تعاد نسخةٌ من الصنف Destructured. أمثلة ينشِئ التابع Regex() في الشيفرة التالية تعبيرًا نمطيًا باسم regex لتفكيك مسارات الملفات إلى ثلاث مُركّبات: المجلد (directory) واسم الملف (fileName) والامتداد (extension)، ثم نعرّف سلسلة نصية باسم fullPath تحتوي مسار أحد الملفات، ثم نستخرج من fullPath مجموعات النتائج عبر استدعاء الدالة ...
الدالة CharSequence.flatMap() في Kotlin
تعيد الدالة flatMap() قائمةً تضم ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف السلسلة التي استُدعيت معها. البنية العامة inline fun <R> CharSequence.flatMap(
transform: (Char) -> Iterable<R>
): List<R>
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات transform دالةٌ تطبق على كل محرف من محارف السلسلة المعطاة، وتعيد قيمة معينة تحل مكانه. القيم المعادة تُعاد قائمةٌ تضم ناتج تطبيق الدالة transform على كل محرف من محارف السلسلة المعطاة. أمثلة مثالٌ على استعمال الدالة ()flatMap: fun main(args: ...
الدالة Byte.dec() في Kotlin
تنقص الدالة dec() القيمة التي استُدعيت معها بمقدار 1 ثم تعيد القيمة الناتجة. البنية العامة operator fun dec(): Byte
وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). القيمة المعادة تعاد قيمة من النوع Byte تمثل القيمة المعطاة بعد انقاصها بمقدار 1. أمثلة استعمال الدالة ()inc لانقاص قيمة عددية: fun main(args: Array<String>) {
val x = 3
println(x.dec()) // 2
}
انظر أيضًا الدالة compareTo(): توازن بين قيمة العنصر الذي استُدعيت ...
الدالة filterNotNullTo() في Kotlin
تشبه الدالة filterNotNullTo() الدالة filterNotNull() في جميع النواحي باستثناء أنَّها تضيف الناتج الذي تعيده إلى المعامل المُمرَّر إليها. الجدير بالذكر أنّه ينبغي أن يكون ذلك المعامل المعطى مجموعةً قابلةً للتغيير (MutableCollection). البنية العامة fun <C : MutableCollection<in T>, T : Any> Array<out T?>.filterNotNullTo(
destination: C
): C
fun <C : MutableCollection<in T>, T : Any> Iterable<T?>.filterNotNullTo(
destination: C
): C
المعاملات destination كائن موجود مسبقًا يمثل الوجهة المراد إضافة الناتج فيها. predicate دالةٌ تمثل الشرط المراد ...
القيمة WARNING في Kotlin
تشير القيمة WARNING إلى وجود تحذير تولد نتيجة استعمال عنصر مهمل (deprecated element). انظر أيضًا القيمة ERROR: تشير إلى وجود خطأٍ تولد نتيجة استعمال عنصر مهمل (deprecated element). القيمة HIDDEN: تشير إلى أن العنصر المهمل (deprecated elements) غير متاح للاستخدام ضمن الشيفرة. مصادر صفحة WARNING في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.
الصنف Charsets في Kotlin
الدوال الموروثة equals تبين الدالة equals() إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت عبره. hashCode يعيد التابع hashCode() قيمة الشيفرة hash code الخاصّة بالكائن الذي استُدعي عبره. toString يعيد التابع toString() تمثيلًا نصيًا للكائن الذي يُستدعى عبره.
الدالة String.format() في Kotlin
تنسِّق الدالة format() سلسلة نصية وفقًا لقيمة المعاملات التي تمرر إليها. البنية العامة inline fun String.format(vararg args: Any?): String
بيئة التشغيل المطلوبة: JVM. تستعمل format() السلسلة النصية التي استُدعيت معها كسلسلة تنسيق نصية (format string) وتعيد سلسلة نصية ناتجة عن تعويض الوسائط args المعطاة وباستخدام الإعدادات الافتراضية للمحلية (locale). inline fun String.Companion.format(
format: String,
vararg args: Any?
): String
بيئة التشغيل المطلوبة: JVM. تستعمل الدالة format() السلسلة النصية format المُمرّرة كسلسلة تنسيق نصية وتعيد سلسلة نصية ناتجة عن ...
الدالة CharArray.get() في Kotlin
يجلب التابع get() عنصرًا ذي فهرس محدد من المصفوفة. يمكن الاستعاضة عن هذه الدالة باستخدام معامل الفهرسة (index operator) المتمثل بالقوسين [] بالشكل: value = arr[index]
البنية العامة operator fun get(index: Int): Char
وجود الكلمة المفتاحية operator يدل على أنّ هذه الدالة مرتبطة بمعامل الفهرسة الذي ذكرناه آنفًا. المعاملات index عدد صحيح يمثل فهرس العنصر المراد جلبه. القيم المعادة يعاد العنصر ذو الفهرس index المحدِّد والموجود في المصفوفة المعطاة. أمثلة استعمال الدالة get() لجلب العنصر الثالث من مصفوفة من النوع CharArray: fun main(args: Array<String>) {
val int: (Int) -> ...
الدالة copyOf() في Kotlin
تنسخ الدالة copyOf() كامل المصفوفة التي استُدعيت معها أو جزءًا منها. البنية العامة inline fun <T> Array<T>.copyOf(): Array<T>
inline fun ByteArray.copyOf(): ByteArray
inline fun ShortArray.copyOf(): ShortArray
inline fun IntArray.copyOf(): IntArray
inline fun LongArray.copyOf(): LongArray
inline fun FloatArray.copyOf(): FloatArray
inline fun DoubleArray.copyOf(): DoubleArray
inline fun BooleanArray.copyOf(): BooleanArray
inline fun CharArray.copyOf(): CharArray
inline fun ByteArray.copyOf(newSize: Int): ByteArray
inline fun ShortArray.copyOf(newSize: Int): ShortArray
inline fun IntArray.copyOf(newSize: Int): IntArray
inline fun LongArray.copyOf(newSize: Int): LongArray
inline fun FloatArray.copyOf(newSize: Int): FloatArray
inline fun DoubleArray.copyOf(newSize: Int): DoubleArray
inline ...
التابع ByteArray.iterator() في Kotlin
ينشئ التابع iterator() عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. البنية العامة operator fun iterator(): ByteIterator
وجود الكلمة المفتاحية operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator، اطلع على المثال في الأسفل). القيم المعادة يعاد عنصرٌ تكراريٌٌ (iterator) من أجل تكرار بنيةٍ (block) برمجيةٍ معينة على كافّة عناصر المصفوفة المعطاة. أمثلة استعمال التابع iterator() لتخصيص عنصر تكراري من أجل استخدامه في الحلقة for التكرارية التي تطبع جميع العناصر: import java.util.Arrays
fun main(args: Array<String>) {
val f: (Int) -> ...
الدالة associateByTo() في Kotlin
تشبه الدالة associateByTo() الدالة associateBy() تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا. البنية العامة inline fun <T, K, M : MutableMap<in K, in T>> Array<out T>.associateByTo(
destination: M,
keySelector: (T) -> K
): M
inline fun <K, M : MutableMap<in K, in Byte>> ByteArray.associateByTo(
destination: M,
keySelector: (Byte) -> K
): M
inline fun <K, M : MutableMap<in K, in Short>> ShortArray.associateByTo(
...
الصنف MatchGroup في Kotlin
يمثل الصنف MatchGroup النتائج التي نحصل عليها من مجموعة واحدة ضمن MatchResult الخاصة بالصنف Regex. data actual class MatchGroup
الدوال البانية <init> تنشئ كائنًا من النوع MatchGroup الذي يمثل النتائج التي نحصل عليها من مجموعة واحدة ضمن MatchResult الخاصة بالصنف Regex. الخاصيات range تمثل مجال الفهارس التي تحدّد مكان مجموعة النتائج التي تم الحصول عليها. value تمثل قيمة مجموعة النتائج التي تم الحصول عليها. الدوال الموروثة equals يبين إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعي معه. hashCode يعيد الشيفرة ...
الخاصية annotationClass في Kotlin
تُستخدَم هذه الخاصيّة للحصول على نسخةٍ (instance) من الصنف KClass بحسب نوع التوصيف الحاليّ. البنية العامة val <T : Annotation> T.annotationClass: KClass<out T>
القيم المعادة نسخةٌ من الصنف KClass متوافقةٌ مع نوع التوصيف (annotation) الحاليّ. انظر أيضًا التوصيفات (annotations) في لغة Kotlin. الصنف KClass : أحد أصناف لغة Kotlin والمُستخدَم لإجراء عمليّات التحقُّق الداخليّة (introspection) مثل: isAbstract ومرئية الوصول (visibility) وغيرها. الواجهة Annotation: الواجهة الأساسيّة التي يُعرَّف استخدامها (implemented) ضمنيًا في جميع واجهات التوصيفات (annotation interfaces). مصادر صفحة الخاصيّة annotationClass في ...
الثابت Double.MIN_VALUE في Kotlin
يمثّل الثابت Double.MIN_VALUE أًصغر قيمة موجبة غير صفرية يمكن أن يأخذها عدد عشري مضاعف (double). البنية العامة const val MIN_VALUE: Double
أمثلة استخدام الثابتة Double.MIN_VALUE لمعرفة أصغر قيمة موجبة غير صفرية يمكن استعمالها مع عدد عشري مضاعف: fun main(args: Array<String>) {
println(Double.MIN_VALUE) // 4.9E-324
}
انظر أيضًا الثابت Double.MAX_VALUE: يمثل أكبر قيمة موجبة نهائية (finite) لعدد عشري مضاعف (double). الثابت Double.NEGATIVE_INFINITY: يمثل قيمة سالبة لانهائية (infinity) لعدد عشري مضاعف (double). الثابت Double.POSITIVE_INFINITY: يمثل قيمة ...
الدالة Double.toShort() في Kotlin
تحوّل الدالة toShort() العدد العشري المضاعف (double) الذي استُدعي معها إلى عدد من النوع Short (عدد قصير). هذا قد يؤدي إلى تدوير العدد المراد تحويله أو اقتطاع جزءٍ منه. البنية العامة fun toShort(): Short
حلت الدالة Number.toShort() مكان هذه الدالة. القيمة المعادة يعاد عدد من النوع Short يحوي العدد العشري المضاعف المراد تحويله. أمثلة استعمال الدالة ()toShort لتحويل عدد من النوع Double إلى النوع Short: fun main(args: Array<String>) {
val x: Double = 52.7
println(x.toShort()) // ...
القيمة HIDDEN في Kotlin
تشير القيمة HIDDEN إلى أن العنصر المهمل (deprecated elements) غير متاح للاستخدام ضمن الشيفرة. انظر أيضًا القيمة WARNING: تشير إلى وجود تحذير تولد نتيجة استعمال عنصر مهمل (deprecated element). القيمة ERROR: تشير إلى وجود خطأٍ تولد نتيجة استعمال عنصر مهمل (deprecated element). مصادر صفحة HIDDEN في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.
الدالة Double.toFloat() في Kotlin
تحوّل الدالة toFloat() العدد العشري المضاعف (double) الذي استُدعي معها إلى عدد عشري (أي من النوع Float). هذا قد يؤدي إلى تدوير العدد المراد تحويله. البنية العامة fun toFloat(): Float
حلت الدالة Number.toFloat() مكان هذه الدالة. القيمة المعادة يعاد عدد عشري (من النوع Float) يحوي العدد العشري المضاعف المعطى. أمثلة استعمال الدالة ()toFloat لتحويل عدد عشري مضاعف إلى عدد عشري: fun main(args: Array<String>) {
val x : Double = 52.0
print(x.toFloat() )// ...
الدالة all() في Kotlin
تتحقق الدالة all() إن كانت كافّة عناصر المصفوفة أو المجموعة (collection) التي استُدعيت عبرها تطابق شرطًا منطقيًّا محدَّدًا. البنية العامة يمكن استدعاء الدالة all() للمصفوفات من الأنواع المختلفة كما يلي: inline fun <T> Array<out T>.all(predicate: (T) -> Boolean): Boolean
inline fun ByteArray.all(predicate: (Byte) -> Boolean): Boolean
inline fun ShortArray.all(predicate: (Short) -> Boolean): Boolean
inline fun IntArray.all(predicate: (Int) -> Boolean): Boolean
inline fun LongArray.all(predicate: (Long) -> Boolean): Boolean
inline fun FloatArray.all(predicate: (Float) -> Boolean): Boolean
inline fun DoubleArray.all(predicate: (Double) -> Boolean): Boolean ...
الدالة trimStart() في Kotlin
تحذف الدالة trimStart() المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من بداية سلسلة المحارف أو السلسلة النصية التي استُدعيت معها. البنية العامة inline fun CharSequence.trimStart(
predicate: (Char) -> Boolean
): CharSequence
inline fun String.trimStart(predicate: (Char) -> Boolean): String
fun CharSequence.trimStart(vararg chars: Char): CharSequence
fun String.trimStart(vararg chars: Char): String
fun CharSequence.trimStart(): CharSequence
inline fun String.trimStart(): String
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات predicate دالةٌ تطبق ...
الدالة toFloatArray() في Kotlin
تحول الدالة 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]
...
الدالة split() في Kotlin
تقتطع الدالة split() المحارف الموجودة بين الأجزاء المتطابقة مع تعبير نمطي معين أو بين سلاسل نصية أو محارف معينة في سلسلة المحارف الممررة إليها وتعيدها في قائمة. البنية العامة fun CharSequence.split(
regex: Pattern,
limit: Int = 0
): List<String>
inline fun CharSequence.split(
regex: Regex,
limit: Int = 0
): List<String>
fun CharSequence.split(
vararg delimiters: String,
ignoreCase: Boolean = false,
limit: Int = 0
): List<String>
fun CharSequence.split(
...
الدالة takeLastWhile() في Kotlin
تجلب الدالة takeLastWhile() آخر عناصر محققة لشرطٍ محدَّدٍ من سلسلة المحارف أو السلسلة النصية التي استُدعيت معها. البنية العامة inline fun CharSequence.takeLastWhile(
predicate: (Char) -> Boolean
): CharSequence
inline fun String.takeLastWhile(
predicate: (Char) -> Boolean
): String
يُلاحَظ وجود الكلمة المفتاحية inline التي تدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات predicate دالةٌ تطبق على كل محرف من محارف سلسلة المحارف أو السلسلة النصية المعطاة. يمرر إليها كل محرف على حدة ثم تعيد قيمة منطقية مقابلة ...
الخاصية CharSequence.length في Kotlin
تمثل الخاصية CharSequence.length عدد عناصر سلسلة المحارف (CharSequence) المستدعاة معها. البنية العامة abstract val length: Int
أمثلة استعمال الخاصية CharSequence.length لمعرفة عدد عناصر سلسلة من الحروف: fun main(args: Array<String>) {
val s = "hsoub"
println(s.length) // 5
}
انظر أيضًا الدالة ()get: تجلب العنصر ذي الفهرس الممرَّر إليها من سلسلة الحروف المستدعاة معها. الدالة subSequence(): تجلب جزءًا محددًا يقع في سلسلة الحروف التي استٌدعيت معها. مصادر صفحة الخاصية CharSequence.length في التوثيق الرسميّ للمكتبة القياسيّة في ...
الدالة sortedByDescending() في Kotlin
ترتِّب الدالة 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 ...
الدالة Byte.inc() في Kotlin
تزيد الدالة inc() القيمة التي استُدعيت معها بمقدار 1 ثم تعيد القيمة الناتجة. البنية العامة operator fun inc(): Byte
القيمة المعادة تعاد قيمة من النوع Byte تمثل القيمة المعطاة بعد زيادتها بمقدار 1. أمثلة استعمال الدالة ()inc لزيادة قيمة عددية: fun main(args: Array<String>) {
val x = 3
println(x.inc() )// 4
}
انظر أيضًا الدالة compareTo(): توازن بين قيمة العنصر الذي استُدعيت معه والقيمة المُمرّرة إليه ثمَّ ...
الدالة indexOfLast() في Kotlin
تجلب الدالة 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: ...
الخاصية Regex.pattern في Kotlin
تمثل الخاصية Regex.pattern النمط الذي استعمل في إنشاء التعبير النمطي الذي استُدعي معها. البنية العامة actual val pattern: String
القيمة المعادة تعاد سلسلة نصية تمثل النمط الذي استعمل في إنشاء التعبير النمطي المعطى. أمثلة استعمال الخاصية Regex.pattern مع تعبير نمطي لمعرفة النمط الأولي الذي استعمل في إنشائه -باستعمال الدالة Regex()-: fun main(args: Array<String>) {
val reg = Regex("""-?\d+(\.\d+)?""")
print(reg.pattern ) // -?\d+(\.\d+)?
}
انظر أيضًا الخاصية Regex.options: تمثل مجموعةَ الخيارات التي استُخدمت في إنشاء التعبير ...
الصنف Enum في Kotlin
يعدُّ الصنف Enum الصنف الأساس لكل الأصناف القابلة للعد (enum classes). إن أردت الاطلاع على معلومات أوسع حول هذه الأصناف، فاقرأ هذا المرجع. abstract class Enum<E : Enum<E>> : Comparable<E> (source)
الدوال البانية (Constructors) <init> يعدُّ الصنف Enum الصنف الأساس لكل أصناف الترقيم (enum classes). الخاصيات name تمثل اسم الثابت المعرف في الكائن enum الذي استُدعي معها كما سُمّي أُثناء تعريف هذا الكائن. ordinal تمثل ترتيب (ordinal) الثابت المعرف في الكائن enum الذي استُدعي معها. الدوال clone ترمي هذه الدالة استثناءً لأنّ ثوابت الصنف Enum لا يمكن أن ...
الدالة sortedArrayWith() في Kotlin
ترتِّب الدالة 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, ...
الصنف DoubleArray في Kotlin
يمثل الصنف CharArray مصفوفةً من الأعداد العشرية المضاعفة. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []char. class DoubleArray
الدوال البانية (Constructors) <init> تنشئ الدالة DoubleArray() البانية مصفوفة جديدة من النوع DoubleArray (أي مصفوفة من الأعداد العشرية المضاعفة [double]) بحجم معين، وتحوي قيمًا محدَّدة أو القيم 0. الخاصيات size تمثِّل الخاصيّة DoubleArray.size عدد العناصر الموجودة في المصفوفة ذات النوع DoubleArray. الدوال get تجلب الدالة get() عنصرًا ذي فهرس محدد من المصفوفة. iterator تنشئ الدالة iterator() عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set تضبط الدالة set() قيمة عنصر ذي ...
الدالة Regex_1 في Kotlin
أصبحت الدالة Regex_1 مهملة، إذ كانت متوافرة من أجل التوافقية الثنائية (binary compatibility). تنشئ هذه الدالة تعبيرًا نمطيًا (regular expression) انطلاقًا من السلسلة النصية المُمرّرة مع استعمال الخيارات الافتراضية. البنية العامة fun Regex_1(pattern: String): Regex (source)
المعاملات pattern سلسلة نصية تمثل النمط الذي سينشأ منه تعبير نمطي. القيم المعادة يعاد كائن من النوع Regex يحتوي على التعبير النمطي pattern بعد ضبطه وفقًا للقيمة الافتراضية للخيارات. انظر أيضًا الدالة Regex(): تنشئ تعبيرًا نمطيًا (regular expression) انطلاقًا من السلسلة النصية المُمرّرة إليه. الدالة findAll(): تبحث عن جميع المحارف المتطابقة مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف الممرَّرة ...
الدالة filterIndexedTo() في Kotlin
تشبه الدالة 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,
...
الدالة CharSequence.commonSuffixWith() في Kotlin
تعيد الدالة commonSuffixWith () أطول لاحقة (Suffix) مُشتركة بين سلسلة المحارف التي استُدعيت معها وسلسلة المحارف المُمرّرة إليها. تأخذ الدالة بالحسبان ألا تقتطع الأزواج البديلة (surrogate pairs) عند جلب البادئة المشتركة تلك. البنية العامة fun CharSequence.commonSuffixWith(
other: CharSequence,
ignoreCase: Boolean = false
): String
المعاملات Other سلسلة المحارف التي يراد جلب اللاحقة المشتركة بينها وبين سلسلة المحارف المعطاة. ignoreCase قيمة منطقية تحدد إن كان يراد تجاهل حالة الحروف أم لا أثناء البحث عن لاحقة مشتركة. ...
الدالة toByteArray() في Kotlin
ترمز الدالة toByteArray() جميع محارف السلسلة النصية التي استٌدعيت معها وفقًا لترميز محدد ثم تضع الناتج في مصفوفة من النوع ByteArray. البنية العامة inline fun String.toByteArray(
charset: Charset = Charsets.UTF_8
): ByteArray
بيئة التشغيل المطلوبة: JVM. يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات charset اسم الترميز المراد تحويل محارف السلسلة النصية المعطاة إليه. القيمة الافتراضية هي: Charsets.UTF_8. القيم المعادة تعاد مصفوفة من النوع ByteArray تحوي ناتج ترميز جميع ...
الخاصية MatchResult.value في Kotlin
تمثل الخاصية MatchResult.value السلسلة النصية المُدخلة، أو جزءًا منها، والمُطابقة للتعبير النمطي. البنية العامة abstract val value: String
القيمة المعادة تعاد سلسلة نصية تحوي السلسلة النصية المُدخلة، أو جزءًا منها، والمُطابقة للتعبير النمطي. أمثلة في الشيفرة التالية، ننشِئ تعبيرًا نمطيًا باسم regex باستخدام التابع Regex()، ثم نعرّف سلسلة نصية باسم str، ثم نستخرج منها مجموعات النتائج عبر استدعاء الدالة matchEntire(). نستخدم بعدئذٍ الخاصية value لاستخراج السلسلة النصية المُطابقة للتعبير النمطي regex و الموجودة في str: fun main(args: Array<String>) {
val pattern = Regex("[a-zA-Z]+([0-9]+)[a-zA-Z]+([0-9]+)[a-zA-Z]+")
val str = ...
الدالة isNotEmpty() في Kotlin
تتحقَّق الدالة isNotEmpty() إن كانت المصفوفة أو المجموعة التي استُدعيت معها فارغةً أم لا. تعمل هذه الدالة بشكل معاكس للدالة isEmpty(). البنية العامة يمكن استدعاء الدالة isNotEmpty() مع المصفوفات والمجموعات: inline fun <T> Array<out T>.isNotEmpty(): Boolean
inline fun ByteArray.isNotEmpty(): Boolean
inline fun ShortArray.isNotEmpty(): Boolean
inline fun IntArray.isNotEmpty(): Boolean
inline fun LongArray.isNotEmpty(): Boolean
inline fun FloatArray.isNotEmpty(): Boolean
inline fun DoubleArray.isNotEmpty(): Boolean
inline fun BooleanArray.isNotEmpty(): Boolean
inline fun CharArray.isNotEmpty(): Boolean
inline fun <T> Collection<T>.isNotEmpty(): Boolean
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من ...
الدالة CharSequence.mapIndexedTo() في Kotlin
تشبه الدالة mapIndexedTo() الدالةَ mapIndexed() في جميع النواحي باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها. البنية العامة inline fun <R, C : MutableCollection<in R>> CharSequence.mapIndexedTo(
destination: C,
transform: (index: Int, Char) -> R
): C
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات destination مجموعة متغيرة تمثل الوجهة التي سيضاف إليها الناتج الذي تعيده الدالة transform. transform دالةٌ تطبق على كل محرف من محارف السلسلة المعطاة. يمرر إليها فهرس ...
الدالة mapIndexedTo() في Kotlin
تشبه الدالة mapIndexedTo() الدالةَ mapIndexed() في جميع النواحي باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها. البنية العامة يمكن استدعاء الدالةmapIndexedTo() مع المصفوفات والمجموعات: inline fun <T, R, C : MutableCollection<in R>> Array<out T>.mapIndexedTo(
destination: C,
transform: (index: Int, T) -> R
): C
inline fun <R, C : MutableCollection<in R>> ByteArray.mapIndexedTo(
destination: C,
transform: (index: Int, Byte) -> R
): C
inline fun <R, C : ...
الدالة CharArray.set() في Kotlin
تضبط الدالة set() قيمة عنصر ذي فهرس محدد موجود في المصفوفة المستدعاة معه. يمكن الاستعاضة عن هذه الدالة باستخدام آلية الإسناد (assignment) ومعامل الفهرسة (index operator) بالشكل: arr[index] = value
البنية العامة operator fun set(index: Int, value: Char)
وجود الكلمة المفتاحية operator يدل على أنّ هذه الدالة مرتبطة بمعامل الفهرسة المذكور سابقًا. المعاملات index عدد صحيح يمثل فهرس العنصر المراد تغيير قيمته وتعيين القيمة value له. value القيمة المراد تعيينها إلى العنصر ذي الفهرس index. أمثلة استعمال الدالة set() لتغيير قيمة العنصر الثاني والثالث إلى 'G' و 'T' على ...
الدالة filterTo() في Kotlin
تشبه الدالة filterTo() الدالة filter() تمامًا باستثناء أنها تضيف الناتج إلى كائن موجود مسبقًا بدلًا من أن تعيده. البنية العامة inline fun <C> CharSequence.filterTo(
destination: C,
predicate: (Char) -> Boolean
): C
وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (لمزيد من التفاصيل، راجع توثيق الدوال المباشرة). المعاملات destination كائن موجود مسبقًا يمثل الوجهة المراد إضافة الناتج فيها. predicate دالةٌ تمثل الشرط المراد تطبيقه على كل محرف من محارف سلسلة المحارف المعطاة. يمرر إلى هذه الدالة محرفٌ ...
الدالة get() في Kotlin
تجلب الدالة get() مجموعةً (group) ذات فهرس محدد. البنية العامة abstract operator fun get(index: Int): MatchGroup?
وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات index عدد صحيح يمثل فهرس المجموعة المراد جلبها. تفهرس المجموعات بدءًا من العدد 1 وحتى عدد المجموعات في التعبير النمطي؛ المجموعة ذات الفهرس 0 تقابل المطابقة الكلية. القيمة المعادة يعاد كائنٌ من النوع MatchGroup إن كانت المجموعة ذات الفهرس index متطابقة، أو تعاد القيمة null خلاف ذلك. انظر أيضًا الدالة MatchGroup(): ...
الدالة toTitleCase() في Kotlin
تحوّل الدالة toTitleCase() المحرف الذي استٌدعي معها إلى محرف عنواني (titlecase). تتكون المحارف العنوانية عادةً من محرفين ملتصقين، مثل 'Dž' أو 'Nj'، إذ يعاملان وكأنَّهما محرفٌ واحدٌ فقط. البنية العامة inline fun Char.toTitleCase(): Char
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة يعاد الحرف Char المعطى بعد تحويله إلى حرف عنواني. أمثلة تُعرّف الشيفرة الآتية حرفًا باسم x ثم تستدعي الدالة toTitleCase() معه، ثم تطبع الناتج: fun main(args: Array<String>) { ...
الصنف Byte في Kotlin
يمثل الصنف Byte عددًا صحيحًا ذا إشارة (signed integer) بحجم 8 بت. في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثَّل كقيم للنوع byte الأساسي. class Byte : Number, Comparable<Byte>
الدوال compareTo توازن الدالة compareTo() بين قيمة العنصر الذي استُدعي معها والقيمة المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية. dec تنقص الدالة dec() القيمة ...
الدالة Char.toChar() في Kotlin
تحول الدالة toChar() القيمة العددية للمحرف الذي استُدعي معها إلى المحرف المقابل (أي من النوع Char). البنية العامة fun toChar(): Char
القيمة المعادة يعاد المحرف الذي تساوي قيمته العددية القيمة العددية للمحرف المعطى. أمثلة استعمال الدالة ()toChar مع المحرف 'f': fun main(args: Array<String>) {
val x = 'f'
print(x.toChar()) // f
}
انظر أيضًا الدالة toByte() : تحوّل المحرف الذي استُدعي معها إلى عدد من النوع Byte. الدالة toDouble(): تحول المحرف الذي ...
الواجهة MatchGroupCollection في Kotlin
تمثل الواجهة MatchGroupCollection مجموعةً (collection) من الفئات المرصودة (captured groups) عند إجراء مطابقة واحدة لتعبير نمطي ما. حجم المجموعة يساوي groupCount + 1، إذ يمثل groupCount عدد الفئات (groups) في التعبير النمطي. الفئات مُفهرسة بدءًا من 1 وحتى groupCount، والفئة ذات الفهرس 0 تقابل كل ما تطابق. يمكن أن يساوي بعض عناصر المجموعة القيمة العدمية (null) في حال كانت الفئة المقابلة في التعبير النمطي اختيارية، ولم يُرصَد أي تطابق من قبل تلك الفئة. interface MatchGroupCollection : Collection<MatchGroup?>
الدوال get تعيد هذه ...
الدالة Float.rem() في Kotlin
تحسب الدالة rem() باقي عملية قسمة العدد العشري (double) الذي استُدعي معها على العدد الممرّر إليها. البنية العامة operator fun rem(other: Byte): Float
operator fun rem(other: Short): Float
operator fun rem(other: Int): Float
operator fun rem(other: Long): Float
operator fun rem(other: Float): Float
operator fun rem(other: Double): Double
وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other العدد الآخر الذي ستُجرَى عليه العملية. القيمة المعادة يعاد عدد عشري يحوي باقي عملية قسمة العدد العشري المعطى على العدد other الممرّر. إن ...
الدالة Double.times() في Kotlin
تضرب الدالة times() العدد الممرّر إليها بالعدد العشري المضاعف (double) المستدعى معها ثم تعيد الناتج. البنية العامة operator fun times(other: Byte): Double
operator fun times(other: Short): Double
operator fun times(other: Int): Double
operator fun times(other: Long): Double
operator fun times(other: Float): Double
operator fun times(other: Double): Double
وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other العدد الآخر الذي ستجرى عليه العملية. القيمة المعادة يعاد عدد عشري مضاعف يحوي ناتج ضرب العدد other الممرّر بالعدد العشري المضاعف المعطى. ...
الدالة String.codePointCount() في Kotlin
تعيد الدالة codePointCount() عدد محارف الترميز الموحد (Unicode code point) الموجودة في مجال مُحدّد من سلسلة نصية. البنية العامة inline fun String.codePointCount(
beginIndex: Int,
endIndex: Int
): Int
منصة التشغيل المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات beginIndex عدد صحيح يشير إلى فهرس العنصر الذي يمثل بداية المجال في السلسلة النصية المعطاة. endIndex عدد صحيح يشير إلى فهرس العنصر (لا يدخل ضمن المجال) ...
الدالة Byte.minus() في Kotlin
تطرح الدالة minus() العدد الممرّر إليها من العدد الذي استُدعي معها ثم تعيد الناتج. البنية العامة operator fun minus(other: Byte): Int
operator fun minus(other: Short): Int
operator fun minus(other: Int): Int
operator fun minus(other: Long): Long
operator fun minus(other: Float): Float
operator fun minus(other: Double): Double
وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other العدد الآخر المراد تطبيق العملية عليه. القيمة المعادة يعاد ناتج طرح العدد الممرّر إلى الدالة من العدد الذي استُدعي معها. ...
الدالة equals() في Kotlin
تتحقق الدالة equals() من تساوي السلسلة النصية أو المحرف الذي استُدعي معها مع السلسلة النصية أو المحرف المُمرّر إليها مع إمكانية تجاهل حالة المحارف. البنية العامة actual fun String?.equals(
other: String?,
ignoreCase: Boolean = false
): Boolean
fun Char.equals(
other: Char,
ignoreCase: Boolean = false
): Boolean
المعاملات other سلسلة نصية أو محرف يراد التحقق من تساويها مع السلسلة النصية أو تساويه مع المحرف المعطى. ignoreCase قيمة منطقية تحدد ...
الدالة replaceBeforeLast() في Kotlin
تبدِّل الدالة replaceBeforeLast() سلسلة نصية مكان كل الجزء الواقع قبل آخر ظهور لمحرف أو لسلسلة نصية معينة في سلسلة نصية. البنية العامة fun String.replaceBeforeLast(
delimiter: Char,
replacement: String,
missingDelimiterValue: String = this
): String
fun String.replaceBeforeLast(
delimiter: String,
replacement: String,
missingDelimiterValue: String = this
): String
المعاملات delimiter المحرف أو السلسلة النصية التي يراد استبدال كامل الجزء الواقع قبلها. replacement السلسلة النصية التي ستحل مكان الجزء الواقع قبل ...
الدالة binarySearch() في Kotlin
تبحث الدالة binarySearch() عن عنصر معين في المجموعة أو مجال من المجموعة (Collection) باستخدام خوارزميَّة البحث الثنائي (binary search algorithm) وتعيد فهرس موقعه. ويجب أن تكون المجموعة مرتبَّةً وفق المُقارِن comparator وإلا فستكون النتيجة المعادة غير مُحدّدة. إن احتوت المصفوفة على عناصر متساوية، فلا يمكن التوقع أيها سيُعاد. تُعيد الدالة فهرس العنصر المبحوث عنه إن كان موجودًا في المجال المحدَّد؛ خلاف ذلك، فستعيد القيمة السالبة لنقطة الإدراج (-insertion point - 1)، وهي الفهرس حيث يجب أن يُدرج العنصر حتى تبقى ...
الدالة contains() في Kotlin
تتحقق الدالة contains() إن كانت المصفوفة أو المجموعة التي استُدعيت معها تحتوي على العنصر الممرّر إليها، أو إن كانت الخريطة التي استدعيت معها تحتوي على ذلك العنصر كمفتاح (key). يمكن استدعاء contains() مع خريطة بالشكل x in map للتحقق من أنّ العنصر x موجود ضمنها. البنية العامة يمكن استدعاء الدالة contains() مع مصفوفات: operator fun <T> Array<out T>.contains(element: T): Boolean
operator fun ByteArray.contains(element: Byte): Boolean
operator fun ShortArray.contains(element: Short): Boolean
operator fun IntArray.contains(element: Int): Boolean
operator fun LongArray.contains(element: Long): Boolean ...
الدالة CharSequence.last() في Kotlin
تجلب الدالة last() آخر محرف من محارف السلسلة التي استُدعيت معها إن لم يمرر إليها أي شيء، أو آخر محرف يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها. إن كانت سلسلة المحارف التي استُدعيت الدالة last() معها فارغةً أو لم يكن هناك أي عنصر يحقق الدالة المنطقية الممرَّرة إليها، فستُطلِق الدالة الاستثناء NoSuchElementException. البنية العامة fun CharSequence.last(): Char (source)
inline fun CharSequence.last(
predicate: (Char) -> Boolean
): Char
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات predicate دالةٌ تمثل الشرط ...
الدالة CharSequence.reduceRight() في Kotlin
تُراكِم الدالة reduceRight() قيمة محرف بدءًا من المحرف الأول عبر تطبيق عملية معينة من يمين سلسلة المحارف المعطاة إلى يسارها على القيمة المتراكمة الحالية وعلى الحرف التالي ثم تُعيد قيمة المحرف النهائي الناتج. البنية العامة inline fun CharSequence.reduceRight(
operation: (Char, acc: Char) -> Char
): Char
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات operation دالة يراد تطبيقها على كل محرف من محارف السلسلة المعطاة. يمرر إليها القيمة المتراكمة الحالية (التي تمثل محرفًا) وقيمة ...
الدالة replaceRange() في Kotlin
تبدِّل الدالة replaceRange() سلسلة معينة من المحارف مكان جزء محدد في سلسلة من المحارف أو سلسلة نصية. سيُرمَى الاستثناء IndexOutOfBoundsException إن وقع مجال الجزء المحدد المراد استبداله خارج مجال سلسلة المحارف أو السلسلة النصية المعطاة. البنية العامة fun CharSequence.replaceRange(
startIndex: Int,
endIndex: Int,
replacement: CharSequence
): CharSequence
inline fun String.replaceRange(
startIndex: Int,
endIndex: Int,
replacement: CharSequence
): String
fun CharSequence.replaceRange(
...
الدالة String.offsetByCodePoints() في Kotlin
تعيد الدالة offsetByCodePoints() فهرس المحرف الموجود في السلسلة النصية التي استٌدعيت معها والذي ينزاح بمقدار محدد بدءًا من عنصر ذي فهرس محدد. البنية العامة inline fun String.offsetByCodePoints(
index: Int,
codePointOffset: Int
): Int
منصة التشغيل المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات index عدد صحيح يمثل فهرس العنصر الذي ستبدأ عنده عملية الإزاحة. codePointOffset عدد صحيح يمثل مقدار الإزاحة. القيم المعادة عدد من ...
الصنف ByteArray في Kotlin
يمثل الصنف ByteArray مصفوفةً من البايتات. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []byte. class ByteArray
الدوال البانية <int> تنشئ الدالة ByteArray() البانية مصفوفة جديدة من النوع ByteArray (أي حجم كل عنصر منها بايتًا واحدًا) بحجم معين، إذ تحوي قيمًا محدَّدة أو القيم 0. الخاصيات size تمثِّل الخاصيّة size عدد العناصر الموجودة في المصفوفة ذات النوع ByteArray. الدوال get يجلب التابع get() عنصرًا ذي فهرس محدد من المصفوفة. iterator ينشئ التابع iterator() عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set يضبط التابع set() قيمة ...
الخاصية ByteArray.size في Kotlin
تمثِّل الخاصيّة size عدد العناصر الموجودة في المصفوفة ذات النوع ByteArray. البنية العامة val size: Int
القيم المعادة يعاد عددٌ صحيحٌ يمثِّل عدد العناصر في المصفوفة المعطاة. أمثلة استعمال الخاصيّة size لمعرفة عدد العناصر الموجود في مصفوفة من النوع ByteArray: fun main(args: Array<String>) {
val array = ByteArray(6)
print(array.size) // 6
}
انظر أيضًا الصنف ByteArray. الدالة ByteArray(): تنشئ مصفوفة جديدة من النوع ByteArray (أي حجم كل عنصر منها بايتًا واحدًا) بحجم معين، إذ تحوي قيمًا محدَّدة أو القيم 0. التابع ()get: يجلب عنصرًا ...
الدالة associateBy() في Kotlin
تعيد الدالة associateBy() خريطةً (map) مكونة من الأزواج "مفتاح/قيمة"، إذ يكون المفتاح (key) هو الناتج الذي تعيده الدالة keySelector الممررة إليها وتكون القيمة (value) المقابلة لذلك المفتاح هي إمَّا عناصر المصفوفة أو المجموعة المعطاة أو الناتج الذي تعيده الدالة valueTransform الممررة. إن كان لعنصرين نفس المفتاح (key) بعد تطبيق الدالة keySelector، فإنَّ الأخير هو الذي سيُضاف إلى الخريطة. تحافظ الخريطة المُعادة على نفس ترتيب التكرار الخاص بالمصفوفة أو المجموعة الأصليَّة. البنية العامة إن استدعيت الدالة associateBy()مع مصفوفة، فستعيد خريطةً (map) ...
الدالة average() في Kotlin
تحسب الدالة average() متوسط (average) عناصر المصفوفة أو المجموعة (Collection) المعطاة لها. البنية العامة يمكن استدعاء الدالة average() مع المصفوفات: @JvmName("averageOfByte") fun Array<out Byte>.average(): Double
@JvmName("averageOfShort") fun Array<out Short>.average(): Double
@JvmName("averageOfInt") fun Array<out Int>.average(): Double
@JvmName("averageOfLong") fun Array<out Long>.average(): Double
@JvmName("averageOfFloat") fun Array<out Float>.average(): Double
@JvmName("averageOfDouble") fun Array<out Double>.average(): Double
fun ByteArray.average(): Double
fun ShortArray.average(): Double
fun IntArray.average(): Double
fun LongArray.average(): Double
fun FloatArray.average(): Double
fun DoubleArray.average(): Double
ويمكن استدعاؤها مع المجموعات: @JvmName("averageOfByte") fun Iterable<Byte>.average(): Double
@JvmName("averageOfShort") fun Iterable<Short>.average(): Double
@JvmName("averageOfInt") fun ...
الدالة toUpperCase() في Kotlin
تحوّل الدالة toUpperCase() المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف كبيرة (uppercase). البنية العامة inline actual fun Char.toUpperCase(): Char
inline actual fun String.toUpperCase(): String
inline fun String.toUpperCase(locale: Locale): String
المنصة المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). المعاملات locale المحلية المراد ضبطها إلى منطقة جغرافية محددة وأخذها بالحسبان أثناء عملية التحويل. القيم المعادة يعاد المحرف Char المعطى بعد تحويله إلى محرف كبير، أو السلسلة النصية ...
الدالة toFloatOrNull() في Kotlin
تحلّل الدالة toFloatOrNull() السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد عشري. في حال لم تكن السلسلة النصية تمثل عددًا، فستعيد الدالة القيمة null. البنية العامة actual fun String.toFloatOrNull(): Float?
بيئة التشغيل المطلوبة: Kotlin 1.1. يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). القيم المعادة يعاد عدد من النوع Float يحوي ناتج تحويل السلسلة النصية المعطاة، أو تعاد القيمة null في حال لم تكن السلسلة النصية تمثل عددًا. أمثلة مثالٌ على استعمال ...
الدالة String.concat() في Kotlin
تضيف الدالة concat() السلسلة النصية التي استُدعيت معها إلى السلسلة النصية المُمرّرة إليها. البنية العامة inline fun String.concat(str: String): String
منصة التشغيل المطلوبة: JS. وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). المعاملات str السلسلة النصية المراد إضافتها إلى السلسلة النصية المعطاة. القيم المعادة تعاد سلسلة نصية ناتجة عن إضافة السلسلة النصية str إلى السلسلة النصية المعطاة. أمثلة مثالٌ عن استعمال الدالة ()concat: fun main(args: Array<String>) {
val str ...
الدالة CharSequence.reduce() في Kotlin
تُراكِم الدالة reduce() قيمة محرف بدءًا من المحرف الأول عبر تطبيق عملية معينة من يسار سلسلة المحارف المعطاة إلى يمينها على القيمة المتراكمة الحالية وعلى الحرف التالي ثم تُعيد قيمة المحرف النهائي الناتج. البنية العامة inline fun CharSequence.reduce(
operation: (acc: Char, Char) -> Char
): Char
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات operation دالة يراد تطبيقها على كل محرف من محارف السلسلة المعطاة. يمرر إليها القيمة المتراكمة الحالية (التي تمثل محرفًا) وقيمة ...
الدالة Byte.times() في Kotlin
تضرب الدالة times() العدد الممرّر إليها بالعدد المستدعى معها ثم تعيد الناتج. البنية العامة operator fun times(other: Byte): Int
operator fun times(other: Short): Int
operator fun times(other: Int): Int
operator fun times(other: Long): Long
operator fun times(other: Float): Float
operator fun times(other: Double): Double
وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other العدد الآخر المراد تطبيق العملية عليه. القيمة المعادة يعاد ناتج ضرب العدد الممرّر إلى الدالة بالعدد المستدعى معها. أمثلة استعمال الدالة ...
عرض (100 السابقة | 100 التالية) (20 | 50 | 100 | 250 | 500).