نتائج البحث
اذهب إلى التنقل
اذهب إلى البحث
الدالة Double.plus() في Kotlin
تجمع الدالة plus() العدد العشري المضاعف (double) الذي استُدعي معها مع العدد الممرّر إليها ثم تعيد الناتج. البنية العامة operator fun plus(other: Byte): Double
operator fun plus(other: Short): Double
operator fun plus(other: Int): Double
operator fun plus(other: Long): Double
operator fun plus(other: Float): Double
operator fun plus(other: Double): Double
وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other العدد الآخر الذي ستُجرَى عليه العملية. القيمة المعادة يعاد عدد عشري مضاعف يحوي ناتج جمع العدد العشري المضاعف المعطى مع ...
الدالة elementAtOrElse() في Kotlin
تجلب الدالة elementAtOrElse() عنصرًا ذي فهرس معيَّن من المصفوفة أو المجموعة التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود المصفوفة أو المجموعة، فستُعيد الدالة ناتج استدعاء دالة معينة. البنية العامة يمكن استدعاء الدالة elementAtOrElse() مع المصفوفات: inline fun <T> Array<out T>.elementAtOrElse(
index: Int,
defaultValue: (Int) -> T
): T
inline fun ByteArray.elementAtOrElse(
index: Int,
defaultValue: (Int) -> Byte
): Byte
inline fun ShortArray.elementAtOrElse(
index: Int, ...
الدالة joinTo() في Kotlin
تضيف الدالة joinTo() بادئة ولاحقة إلى جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها (أو جزءٍ منها) وتفصلها بفاصلة معينة ثمَّ تضيفها إلى سلسة نصية موجودة مسبقًا. إن كانت المجموعة كبيرة، فيمكن تحديد جزءٍ أولي معين منها فقط لإضافته إلى السلسلة النصية؛ في هذه الحالة، تضاف سلسلة نصية معينة، مثل "..." أو "...إلخ" إلى السلسلة النصية الناتجة للدلالة على وجود جزء مقتطع. البنية العامة fun <T, A> Array<out T>.joinTo(
buffer: A,
separator: CharSequence ...
الصنف CharSequence في Kotlin
تمثل الواجهة CharSequence سلسلةً من المحارف قابلةً للقراءة. interface CharSequence
الخاصيات length تمثل الخاصية CharSequence.length عدد عناصر سلسلة المحارف (CharSequence) المستدعاة معها. الدوال get تجلب الدالة get() المحرف ذا الفهرس الممرَّر إليها من سلسلة المحارف المستدعاة معها. subSequence تجلب الدالة subSequence() جزءًا محددًا يقع في سلسلة المحارف التي استٌدعيت معها. الدوال الموروثة (Inherited Functions) equals تتحقق الدالة equals() إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معه. hashCode تعيد الدالة hashCode() الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. toString تحول الدالة toString() الكائن الذي يُستدعى معه إلى سلسلة نصية (String). الخاصيات الإضافية (Extension Properties) ...
الدالة iterator() في Kotlin
تسمح الدالة iterator() بالتكرار (iterate) على كائنٍ ديناميكيّ (dynamic) في الحالات الآتية: إن كان لديه دالة تكراريّة (iterator function). إن كان مصفوفةً (array). إن كان نسخةً (instance) من Kotlin.collections.Iterable. البنية العامة operator fun dynamic.iterator(): Iterator<dynamic>
بيئة التشغيل المطلوبة: JS. ويُلاحظ وجود الكلمة المفتاحيّة operator للدلالة على أنّ هذه الدالة مرتبطٌ بمعامل التكرار (iteration operator). انظر أيضًا الدالة ()asDynamic: تعيد قيمة الكائن الذي استدعيت عبره على شكل قيمةٍ من النوع الديناميكيّ (dynamic type). مصادر صفحة الدالة iterator() في التوثيق الرسميّ للمكتبة القياسيّة ...
الدالة zip() في Kotlin
تنشئ الدالة zip() أزواجًا من عناصر كائنين لها نفس الفهرس، أو تنشئ قيمًا عبر تمرير عناصر لها نفس الفهرس تجلب من كائنين مختلفين إلى دالة معينة. البنية العامة إن استدعيت الدالة zip() مع مصفوفة ومع تمرير مصفوفة أخرى إليها كوسيط، فستشكل أزواجًا من عناصر هاتين المصفوفتين التي لها نفس الفهرس وتضعها في قائمة؛ طول القائمة المعادة يساوي طول أٌقصرهما. infix fun <T, R> Array<out T>.zip(
other: Array<out R>
): List<Pair<T, R>>
infix fun <R> ByteArray.zip(
...
الدالة sortedArrayDescending() في Kotlin
ترتِّب الدالة sortedArrayDescending() جميع عناصر المصفوفة التي استُدعيت معها تنازليًّا ثمَّ تضع الناتج في مصفوفة جديدة. البنية العامة fun <T : Comparable<T>> Array<T>.sortedArrayDescending(): Array<T>
fun ByteArray.sortedArrayDescending(): ByteArray
fun ShortArray.sortedArrayDescending(): ShortArray
fun IntArray.sortedArrayDescending(): IntArray
fun LongArray.sortedArrayDescending(): LongArray
fun FloatArray.sortedArrayDescending(): FloatArray
fun DoubleArray.sortedArrayDescending(): DoubleArray
fun CharArray.sortedArrayDescending(): CharArray
القيمة المعادة تعاد مصفوفة جديدة تضم عناصر المصفوفة المعطاة بعد ترتيبها تصاعديًّا. أمثلة استعمال الدالة ()sortedArrayDescending لترتيب عناصر مصفوفة تنازليًّا: import java.util.Arrays
fun main(args: Array<String>) {
val array = arrayOf(1, 9, -3, 7, 5, 6)
...
الدالة Byte.toFloat() في Kotlin
تحوِّل الدالة toFloat() العدد الذي استُدعي معها إلى عدد من النوع Float، وهذا قد يؤدي إلى تقريب العدد. البنية العامة fun toFloat(): Float
القيمة المعادة يعاد عدد من النوع Float. أمثلة استعمال الدالة ()toFloat لتحويل عدد من النوع Double إلى النوع Float: fun main(args: Array<String>) {
val x: Double = 257.123456789
println(x.toFloat())// 257.12344
}
انظر أيضًا الدالة toByte(): تحوّل العدد الذي استُدعي معها إلى عدد من النوع Byte، وهذا قد يؤدي إلى تقريب العدد أو اقتطاع جزءٍ ...
الدالة Float.toByte() في Kotlin
تحوّل الدالة toByte() العدد العشري (float) الذي استُدعي معها إلى عدد من النوع Byte. هذا قد يؤدي إلى تدوير العدد المراد تحويله أو اقتطاع جزءٍ منه. البنية العامة fun toByte(): Byte
القيمة المعادة يعاد عدد من النوع Byte يحوي العدد العشري المعطى. أمثلة استعمال الدالة ()toByte لتحويل عدد عشري إلى عدد من النوع Byte: fun main(args: Array<String>) {
val x: Float = 52.43f
print(x.toByte()) // 52
}
انظر أيضًا الدالة toChar(): تحول العدد ...
الدالة dropWhile() في Kotlin
تعيد الدالة dropWhile() قائمةً تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء العناصر الأولى التي تحقق شرطًا معيَّنًا. البنية العامة inline fun <T> Array<out T>.dropWhile(
predicate: (T) -> Boolean
): List<T>
inline fun ByteArray.dropWhile(
predicate: (Byte) -> Boolean
): List<Byte>
inline fun ShortArray.dropWhile(
predicate: (Short) -> Boolean
): List<Short>
inline fun IntArray.dropWhile(
predicate: (Int) -> Boolean
): List<Int>
inline fun LongArray.dropWhile(
predicate: (Long) -> Boolean
): List<Long>
inline ...
الدالة takeLast() في Kotlin
تجلب الدالة takeLast() آخر n عنصر من المصفوفة أو المجموعة التكرارية التي استُدعيت معها وتضعها في قائمة. البنية العامة fun <T> Array<out T>.takeLast(n: Int): List<T>
fun ByteArray.takeLast(n: Int): List<Byte>
fun ShortArray.takeLast(n: Int): List<Short>
fun IntArray.takeLast(n: Int): List<Int>
fun LongArray.takeLast(n: Int): List<Long>
fun FloatArray.takeLast(n: Int): List<Float>
fun DoubleArray.takeLast(n: Int): List<Double>
fun BooleanArray.takeLast(n: Int): List<Boolean>
fun CharArray.takeLast(n: Int): List<Char>
fun <T> List<T>.takeLast(n: Int): List<T>
المعاملات n عدد صحيح يمثل عدد العناصر الأخيرة المراد جلبها من المصفوفة أو المجموعة التكرارية المعطاة. إن كانت القيمة المعطاة لهذا المعامل أكبر من طول المصفوفة أو المجموعة التكرارية، فستعاد ...
الدالة flatMap() في Kotlin
تعيد الدالة flatMap() قائمةً تضم ناتج تطبيق الدالة المُمرّرة إليها على عناصر المصفوفة، أو المجموعة، أو الخريطة التي استُدعيت معها. البنية العامة يمكن استدعاء الدالة flatMap() مع المصفوفات: inline fun <T, R> Array<out T>.flatMap(
transform: (T) -> Iterable<R>
): List<R>
inline fun <R> ByteArray.flatMap(
transform: (Byte) -> Iterable<R>
): List<R>
inline fun <R> ShortArray.flatMap(
transform: (Short) -> Iterable<R>
): List<R>
inline fun <R> IntArray.flatMap(
transform: (Int) -> Iterable<R>
): List<R>
inline fun ...
الصنف Typography في Kotlin
تعرّف أسماء لرموز اليونيكود المستخدمة في الطباعة الخاصة. الدوال الموروثة equals تبين الدالة equals() إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت عبره. hashCode يعيد التابع hashCode() قيمة الشيفرة hash code الخاصّة بالكائن الذي استُدعي عبره. toString يعيد التابع toString() تمثيلًا نصيًا للكائن الذي يُستدعى عبره.
الدالة foldRight() في Kotlin
تجمع الدالة foldRight() بشكل تراكمي ناتج تطبيق عملية معيَّنة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها والقيمة التراكمية الحالية بالإضافة إلى القيمة الأولية إن أعطيت. البنية العامة inline fun <T, R> Array<out T>.foldRight(
initial: R,
operation: (T, acc: R) -> R
): R
inline fun <R> ByteArray.foldRight(
initial: R,
operation: (Byte, acc: R) -> R
): R
inline fun ...
الدالة Byte.toShort() في Kotlin
تحوِّل الدالة toShort() العدد الذي استُدعي معها إلى عدد من النوع Short، وهذا قد يؤدي إلى تقريب العدد أو اقتطاع جزءٍ منه. البنية العامة fun toShort(): Short
القيمة المعادة يعاد عدد من النوع Short. أمثلة استعمال الدالة ()toShort لتحويل عدد من النوع Byte إلى النوع Short: fun main(args: Array<String>) {
val x: Byte = 52
println(x.toShort()) // 52
...
الصنف CharArray في Kotlin
يمثل الصنف CharArray مصفوفةً من المحارف. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []char. class CharArray
الدوال البانية <init> تنشئ الدالة CharArray() البانية مصفوفة جديدة من النوع CharArray (أي مصفوفة من الحروف) بحجم معين، وتحوي قيمًا محدَّدة أو القيمة '\u0000' التي تمثل حرفًا عدميًّا. الخاصيات size تمثِّل الخاصيّة CharArray.size عدد العناصر الموجودة في المصفوفة ذات النوع CharArray. الدوال get يجلب التابع get() عنصرًا ذي فهرس محدد من المصفوفة. iterator تنشئ الدالة iterator() عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set تضبط الدالة set() قيمة عنصر ذي فهرس ...
الدالة toMutableList() في Kotlin
تحول الدالة toMutableList() المصفوف أو المجموعة التي استُدعيت معها إلى قائمة متغيرة. البنية العامة يمكن استدعاء الدالة toMutableList() مع المصفوفات: fun <T> Array<out T>.toMutableList(): MutableList<T>
fun ByteArray.toMutableList(): MutableList<Byte>
fun ShortArray.toMutableList(): MutableList<Short>
fun IntArray.toMutableList(): MutableList<Int>
fun LongArray.toMutableList(): MutableList<Long>
fun FloatArray.toMutableList(): MutableList<Float>
fun DoubleArray.toMutableList(): MutableList<Double>
fun BooleanArray.toMutableList(): MutableList<Boolean>
fun CharArray.toMutableList(): MutableList<Char>
ومع المجموعات أيضًا: fun <T> Iterable<T>.toMutableList(): MutableList<T>
fun <T> Collection<T>.toMutableList(): MutableList<T>
القيمة المعادة تُعاد قائمة متغيرة تحوي جميع عناصر المصفوفة أو المجموعة المعطاة. أمثلة استعمال الدالة ()toMutableList لتحويل مصفوفة إلى قائمة متغيرة: fun main(args: ...
الدالة DoubleArray.get() في Kotlin
تجلب الدالة get() عنصرًا ذي فهرس محدد من المصفوفة. يمكن الاستعاضة عن هذه الدالة باستخدام معامل الفهرسة (index operator) المتمثل بالقوسين [] بالشكل: value = arr[index]
البنية العامة operator fun get(index: Int): Double
وجود الكلمة المفتاحية operator يدل على أنّ هذه الدالة مرتبط بمعامل الفهرسة الذي ذكرناه آنفًا. المعاملات index عدد صحيح يمثل فهرس العنصر المراد جلبه. القيم المعادة يعاد العنصر ذو الفهرس index المحدِّد والموجود في المصفوفة المعطاة. أمثلة استعمال الدالة get() لجلب العنصر الثالث من مصفوفة من النوع DoubleArray: import java.util.Arrays
fun main(args: Array<String>) {
val f: (Int) ...
الخاصية Enum.name في Kotlin
تمثِّل الخاصية Enum.name اسم الثابت المعرف في الكائن enum الذي استُدعي معها كما سُمّي أُثناء تعريف هذا الكائن. البنية العامة val name: String
أمثلة يوضح المثال التالي كيفية إنشاء نسخة من الصنف Enum باسم ColorEnum مكونًا من أربعة ثوابت هي: Red و Blue و Green و Orange، واستعمال الخاصية Enum.name مع الثابتين RED و BLUE: fun main(args: Array<String>) {
print(ColorEnum.Red.name) // Red
print(ColorEnum.Blue.name) // Blue
}
enum class ColorEnum(val colorCode: Int)
{
Red(2),
Blue(11212),
...
الدالة toIntArray() في Kotlin
تحول الدالة toIntArray() المصفوفة العامة (أي من النوع Array<Int>) أو المجموعة التي استُدعيت معها إلى مصفوفة من النوع IntArray. البنية العامة fun Array<out Int>.toIntArray(): IntArray
fun Collection<Int>.toIntArray(): IntArray
القيمة المعادة تعاد مصفوفة من النوع IntArray تحوي جميع عناصر المصفوفة العامة (أي من النوع Array<Int>) أو المجموعة المعطاة. أمثلة استعمال الدالة ()toIntArray لتحويل مصفوفة من النوع Array<Int> إلى النوع IntArray: import java.util.Arrays
fun main(args: Array<String>) {
val array: Array<Int> = arrayOf(4, 5, 6)
println(Arrays.toString(array.toIntArray())) // [4, 5, 6]
...
الدالة Enum.equals() في Kotlin
تتحقق الدالة equals() إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعي معها. استدعاء هذه الدالة يجب أن يكون: انعكاسيًا (Reflexive): لكل مرجع x لا يساوي null، يجب أن يعيد استدعاء x.equals(x) القيمة true. تماثليًَا (Symmetric): لكل قيمتين مرجعيتين x و y لا تساويان null، سيعيد الاستدعاء x.equals(y) القيمة true إذا، وفقط، إذا أعادت y.equals(x) القيمة true. تواتريًا (Transitive): لكل القيم المرجعية x و y و z التي لا تساوي null، سيعيد استدعاء x.equals(z) القيمة true إن أعادت x.equals(y) و ...
الخاصية DoubleArray.size في Kotlin
تمثِّل الخاصيّة DoubleArray.size عدد العناصر الموجودة في المصفوفة ذات النوع DoubleArray. البنية العامة val size: Int
القيم المعادة يعاد عددٌ صحيحٌ يمثِّل عدد العناصر في المصفوفة المعطاة. أمثلة استعمال الخاصيّة size لمعرفة عدد العناصر الموجود في مصفوفة من النوع DoubleArray: fun main(args: Array<String>) {
val array = DoubleArray(6)
print(array.size) // 6
}
انظر أيضًا الصنف DoubleArray. الدالة DoubleArray(): تنشئ مصفوفة جديدة من النوع DoubleArray (أي مصفوفة من الأعداد العشرية المضاعفة) بحجم معين، وتحوي قيمًا محدَّدة أو القيم 0. الدالة ()get: تجلب عنصرًا ذي فهرس محدد من المصفوفة. الدالة iterator(): تنشئ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على ...
الدالة contentHashCode() في Kotlin
تشفِّر الدالة contentHashCode() محتوى المصفوفة التي استُدعيت معها كما لو كانت قائمة إلى شيفرة Hash. البنية العامة inline fun <T> Array<out T>.contentHashCode(): Int
inline fun ByteArray.contentHashCode(): Int
inline fun ShortArray.contentHashCode(): Int
inline fun IntArray.contentHashCode(): Int
inline fun LongArray.contentHashCode(): Int
inline fun FloatArray.contentHashCode(): Int
inline fun DoubleArray.contentHashCode(): Int
inline fun BooleanArray.contentHashCode(): Int
inline fun CharArray.contentHashCode(): Int
الإصدار المطلوب: Kotlin 1.1 وجود الكلمة المفتاحية inline يدل على أنَّ الدالة مباشرة (راجع للمزيد من التفاصيل توثيق الدوال المباشرة). القيم المعادة تعيد شيفرة Hash لمحتوى المصفوفة التي استُدعيت معها ...
الدالة sumBy() في Kotlin
تجمع الدالة sumBy() جميع نواتج تطبيق دالة معيَّنة على كل عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها. الفرق بين الدالة sumBy() والدالة sumByDouble() هو في نوع القيمة التي تستطيع الدالة الممرَّر إلى كلٍّ منهما إعادتها، إذ تعيد الدالة المُمرَّرة إلى sumBy() عددًّا صحيحًا (integer) بينما يمكن أن تعيد الدالة الممرَّرة إلى sumByDouble() عددًا عشريًّا مضاعفًا (double). البنية العامة يمكن استدعاء الدالة sumBy() مع المصفوفات والمجموعات: inline fun <T> Array<out T>.sumBy(selector: (T) -> Int): Int
inline fun ByteArray.sumBy(selector: (Byte) -> Int): Int
inline ...
الصنف 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) الثابت المعرف في ...
الدالة until() في Kotlin
تنشئ الدالة until() مجالًا (range) تصاعديًا يبدأ القيمة التي استُدعيت معها وحتى القيمة الممرّرة إليها (لا تدخل هذه القيمة ضمن المجال). البنية العامة infix fun Int.until(to: Byte): IntRange
infix fun Long.until(to: Byte): LongRange
infix fun Byte.until(to: Byte): IntRange
infix fun Short.until(to: Byte): IntRange
infix fun Long.until(to: Int): LongRange
infix fun Int.until(to: Short): IntRange
infix fun Long.until(to: Short): LongRange
infix fun Byte.until(to: Short): IntRange
infix fun Short.until(to: Short): IntRange
تنشئ الدالة until() مجالًا تصاعديًا يبدأ من القيمة التي استُدعيت معها وينتهي عند ...
الدالة takeIf() في Kotlin
تعيد الدالة takeIf() الكائن (object) الذي استُدعي معها إن كان ذلك الكائن يحقق شرطًا معيّنًا، أو تعيد القيمة null بخلاف ذلك. البنية العامة inline fun <T> T.takeIf(predicate: (T) -> Boolean): T?
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions). المعاملات predicate دالةٌ تطبق على كل كائن من الكائنات المعطاة وتعيد قيمة منطقية مقابلة لكلٍّ منها. القيم المعادة الكائن الذي استُدعيت الدالة معها إن كان ذلك الكائن يحقق الشرط prediacte، ...
الدالة sortBy() في Kotlin
ترتِّب الدالة sortBy() عناصر المصفوفة أو القائمة المتغيرة (MutableList) التي استُدعيت معها تصاعديًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر. البنية العامة يمكن استدعاء الدالة sortBy() مع المصفوفات والقوائم المتغيرة: inline fun <T, R : Comparable<R>> Array<out T>.sortBy(
crossinline selector: (T) -> R?)
inline fun <T, R : Comparable<R>> MutableList<T>.sortBy(
crossinline selector: (T) -> R?)
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات ...
الدالة minWith() في Kotlin
تجلب الدالة minWith() العنصر أو الزوج الأول من المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها والذي له أصغر قيمة بحسب الموازن comparator المعطى. البنية العامة يمكن استدعاء الدالة maxWith() مع المصفوفات و المجموعات والخرائط: fun <T> Array<out T>.minWith(
comparator: Comparator<in T>
): T? (source)
fun ByteArray.minWith(comparator: Comparator<in Byte>): Byte? (source)
fun ShortArray.minWith(
comparator: Comparator<in Short>
): Short? (source)
fun IntArray.minWith(comparator: Comparator<in Int>): Int? (source)
fun LongArray.minWith(comparator: Comparator<in Long>): Long? (source)
fun FloatArray.minWith(
comparator: Comparator<in Float>
): Float? (source)
fun ...
الثابت Char.MIN_LOW_SURROGATE في Kotlin
يمثل الثابت Char.MIN_LOW_SURROGATE القيمة الدنيا للبديل الأدنى لعدد بتات الترميز الموحد (Unicode low-surrogate code unit). البنية العامة const val MIN_LOW_SURROGATE: Char
انظر أيضًا الثابت Char.MAX_HIGH_SURROGATE: يمثّل القيمة القصوى للبديل الأعلى لوحدة اليونيكود (Unicode high-surrogate code unit). الثابت Char.MAX_LOW_SURROGATE: يمثل القيمة القصوى للبديل الأدنى لوحدة اليونيكود (Unicode low-surrogate code unit). الثابت Char.MAX_SURROGATE: يمثِّل القيمة القصوى لبديل وحدة اليونيكود (Unicode surrogate code unit). الثابت Char.MIN_HIGH_SURROGATE: يمثل القيمة الدنيا للبديل الأعلى لوحدة اليونيكود (Unicode high-surrogate code unit). الثابت Char.MIN_SURROGATE: يمثل القيمة الدنيا لبديل ...
الدالة Char.toLong() في Kotlin
تحوّل الدالة toLong() المحرف الذي استُدعي معه إلى عدد من النوع Long. البنية العامة fun toLong(): Long
القيمة المعادة يعاد عدد من النوع Long يمثِّل القيمة العددية للمحرف المعطى. أمثلة استعمال الدالة ()toLong لتحويل المحرف 'a' إلى عدد من النوع Long: fun main(args: Array<String>) {
val x = 'a'
print(x.toLong()) // 97
}
انظر أيضًا الدالة toByte() : تحوّل المحرف الذي استُدعي معها إلى عدد من النوع Byte. ...
الصنف CharArray في Kotlin
يمثل الصنف CharArray مصفوفةً من المحارف. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []char. class CharArray
الدوال البانية <init> تنشئ الدالة CharArray() البانية مصفوفة جديدة من النوع CharArray (أي مصفوفة من الحروف) بحجم معين، وتحوي قيمًا محدَّدة أو القيمة '\u0000' التي تمثل حرفًا عدميًّا. الخاصيات size تمثِّل الخاصيّة CharArray.size عدد العناصر الموجودة في المصفوفة ذات النوع CharArray. الدوال get يجلب التابع get() عنصرًا ذي فهرس محدد من المصفوفة. iterator تنشئ الدالة iterator() عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set تضبط الدالة set() قيمة عنصر ذي فهرس ...
الدالة foldRightIndexed() في Kotlin
تجمع الدالة foldRightIndexed() ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي بالإضافة إلى القيمة الأولية إن أعطيت. البنية العامة يمكن استدعاء الدالة foldRightIndexed() مع المصفوفات: inline fun <T, R> Array<out T>.foldRightIndexed(
initial: R,
operation: (index: Int, T, acc: R) -> R
): R
inline fun <R> ByteArray.foldRightIndexed(
initial: R,
operation: (index: ...
الدالة sum() في Kotlin
تجمع الدالة sum() جميع قيم عناصر المصفوفة أو المجموعة التي استُدعيت معها ثمَّ تعيد الناتج. البنية العامة يمكن استدعاء الدالة sum() مع المصفوفات: @JvmName("sumOfByte") fun Array<out Byte>.sum(): Int
@JvmName("sumOfShort") fun Array<out Short>.sum(): Int
@JvmName("sumOfInt") fun Array<out Int>.sum(): Int
@JvmName("sumOfLong") fun Array<out Long>.sum(): Long
@JvmName("sumOfFloat") fun Array<out Float>.sum(): Float
@JvmName("sumOfDouble") fun Array<out Double>.sum(): Double
fun ByteArray.sum(): Int
fun ShortArray.sum(): Int
fun IntArray.sum(): Int
fun LongArray.sum(): Long
fun FloatArray.sum(): Float
fun DoubleArray.sum(): Double
ومع المجموعات أيضًا : @JvmName("sumOfByte") fun Iterable<Byte>.sum(): Int
@JvmName("sumOfShort") fun Iterable<Short>.sum(): Int
@JvmName("sumOfInt") fun Iterable<Int>.sum(): Int ...
الدالة asSequence() في Kotlin
تُنشِئ الدالة asSequence() نسخةً (instance) من النوع sequence والتي تُغلّف المصفوفة الأصلية وتعيد عناصرها عندما تُستخدَم في حلقات التكرار (مثل حلقة for). البنية العامة تختلف بحسب نوع المصفوفة التي تُستدعَى عبرها: fun <T> Array<out T>.asSequence(): Sequence<T>
fun ByteArray.asSequence(): Sequence<Byte>
fun ShortArray.asSequence(): Sequence<Short>
fun IntArray.asSequence(): Sequence<Int>
fun LongArray.asSequence(): Sequence<Long>
fun FloatArray.asSequence(): Sequence<Float>
fun DoubleArray.asSequence(): Sequence<Double>
fun BooleanArray.asSequence(): Sequence<Boolean>
fun CharArray.asSequence(): Sequence<Char>
ويمكن استدعاء الدالة asSequence()عبر مجموعة (collection) وستعيد نسخةً من النوع sequence والتي تُغلّف المجموعة التي استُدعيت عبرها وتعيد عناصرها عندما تُستخدَم ...
الدالة Float.minus() في Kotlin
تطرح الدالة minus() العدد الممرّر إليها من العدد العشري (float) الذي استُدعي معها ثم تعيد الناتج. البنية العامة operator fun minus(other: Byte): Float
operator fun minus(other: Short): Float
operator fun minus(other: Int): Float
operator fun minus(other: Long): Float
operator fun minus(other: Float): Float
operator fun minus(other: Double): Double
وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other العدد الآخر الذي ستُجرَى عليه العملية. القيمة المعادة يعاد عدد عشري يحوي ناتج طرح العدد other الممرّر من العدد العشري المعطى. إن ...
الصنف Double في Kotlin
يمثل الصنف Double عددًا عشريًّا مضاعفًا (دقة مضاعفة للأعداد بعد الفاصلة [double-precision floating point]) بحجم 64 بت مطابقًا للمعيار IEEE 754. في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثَّل كقيم للنوع double الأساسي. class Double : Number, Comparable<Double>
الدوال compareTo توازن الدالة compareTo() بين عدد عشري مضاعف (double) وعدد آخر ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كان العدد الأول (العدد الذي استُدعي مع الدالة) أصغر من العدد الثاني الممرر إليها، أو قيمة موجبة إن كان العدد الأول أكبر ...
الدالة Byte.unaryMinus() في Kotlin
تعيد الدالة unaryMinus() القيمة السالبة المقابلة للقيمة التي استُدعيت معها. البنية العامة operator fun unaryMinus(): Int
وجود الكلمة المفتاحيّة operator يدل على أنّ هذه الدالة مرتبطٌة بمعامل تكرار (iteration operator). القيمة المعادة تعاد القيمة السالبة للقيمة المعطاة. أمثلة استعمال الدالة ()unaryMinus لإعادة قيمة سالبة لعدد: fun main(args: Array<String>) {
val x: Byte = 52
println(x.unaryMinus()) // -52
}
انظر أيضًا الدالة unaryPlus(): تعيد القيمة التي استدعيت معها. الدالة minus(): تطرح العدد الممرّر إليها من العدد ...
الدالة fill() في Kotlin
تبدِّل الدالة fill() قيمة جديدة معطاة مكان عناصر محدَّدة في المصفوفة أو القائمة التي تستدعى معها. البنية العامة يمكن استدعاء الدالة fill() مع المصفوفات: fun <T> Array<T>.fill(
element: T,
fromIndex: Int = 0,
toIndex: Int = size)
fun ByteArray.fill(
element: Byte,
fromIndex: Int = 0,
toIndex: Int = size)
fun ShortArray.fill(
element: Short,
...
الدالة filterIndexed() في Kotlin
ترشِّح الدالة filterIndexed() عناصر المصفوفة أو المجموعة المعطاة بناءً على فهرس العنصر وقيمته. البنية العامة inline fun <T> Array<out T>.filterIndexed(
predicate: (index: Int, T) -> Boolean
): List<T>
inline fun ByteArray.filterIndexed(
predicate: (index: Int, Byte) -> Boolean
): List<Byte>
inline fun ShortArray.filterIndexed(
predicate: (index: Int, Short) -> Boolean
): List<Short>
inline fun IntArray.filterIndexed(
predicate: (index: Int, Int) -> Boolean
): List<Int>
inline fun LongArray.filterIndexed(
predicate: (index: Int, Long) -> ...
الدالة sortedDescending() في Kotlin
ترتِّب الدالة sortedDescending() جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها تنازليًّا ثمَّ تضع الناتج في قائمة. البنية العامة fun <T : Comparable<T>> Array<out T>.sortedDescending(): List<T>
fun ByteArray.sortedDescending(): List<Byte>
fun ShortArray.sortedDescending(): List<Short>
fun IntArray.sortedDescending(): List<Int>
fun LongArray.sortedDescending(): List<Long>
fun FloatArray.sortedDescending(): List<Float>
fun DoubleArray.sortedDescending(): List<Double>
fun CharArray.sortedDescending(): List<Char>
fun <T : Comparable<T>> Iterable<T>.sortedDescending(): List<T>
القيمة المعادة تُعاد قائمة تضم عناصر المصفوفة أو المجموعة التكرارية المعطاة بعد ترتيبها تنازليًّا. أمثلة استعمال الدالة ()sortedDescending لترتيب عناصر مصفوف تنازليًّا: fun main(args: Array<String>) {
val array = arrayOf(1, ...
الدالة Double.dec() في Kotlin
تنقص الدالة dec() العدد العشري المضاعف (double) الذي استُدعي معها بمقدار 1 ثمَّ تعيد القيمة الناتجة. البنية العامة operator fun dec(): Double
وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). القيمة المعادة تعاد قيمة من النوع Double تمثل القيمة المعطاة بعد انقاصها بمقدار 1. أمثلة استعمال الدالة ()dec لإنقاص عدد عشري مضاعف بمقدار 1 فقط: fun main(args: Array<String>) {
val x: Double = 3.4
println(x.dec()) // 2.4
}
...
التابع ByteArray.get() في Kotlin
يجلب التابع get() عنصرًا ذي فهرس محدد من المصفوفة. يمكن الاستعاضة عن هذا التابع باستخدام معامل الفهرسة (index operator) المتمثل بالقوسين [] بالشكل: value = arr[index]
البنية العامة operator fun get(index: Int): Byte
وجود الكلمة المفتاحية operator يدل على أنّ هذا التابع مرتبط بمعامل الفهرسة الذي ذكرناه آنفًا. المعاملات index عدد صحيح يمثل فهرس العنصر المراد جلبه. القيم المعادة يعاد العنصر ذو الفهرس index المحدِّد والموجود في المصفوفة المعطاة. أمثلة استعمال التابع get() لجلب العنصر الثالث من مصفوفة من النوع ByteArray: import java.util.Arrays
fun main(args: Array<String>) {
val f: ...
الدالة filterNot() في Kotlin
تعيد الدالة filterNot() قائمةً تحوي عناصر المصفوفة أو المجموعة التي لم تحقق شرطًا منطقيًّا محدَّدًا. إن استدعيت مع خريطة (map)، فستعيد خريطة جديدة تحوي الأزواج التي لم تحقق ذلك الشرط المنطقي. تحافظ هذه الخريطة الجديد على ترتيب تكرار المدخلات (entry iteration order) كما في الخريطة الأصلية. البنية العامة يمكن استدعاء الدالة filterNot() مع المصفوفات أو المجموعات: inline fun <T> Array<out T>.filterNot(
predicate: (T) -> Boolean
): List<T>
inline fun ByteArray.filterNot(
predicate: (Byte) -> Boolean
): List<Byte> ...
الدالة Char.plus() في Kotlin
تجمع الدالة plus() القيمة العددية الممرَّرة إليها مع القيمة العددية للمحرف المستدعى معها ثمَّ تعيد المحرف الذي يقابل القيمة الناتجة. البنية العامة operator fun plus(other: Int): Char
وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other عدد صحيح يراد جمعه مع القيمة العددية للمحرف المعطى. القيمة المعادة يعاد المحرف الذي قيمته العددية هي حاصل جمع القيمة العددية other الصحيحة مع القيمة العددية للمحرف المعطى. أمثلة استعمال الدالة ()plus لجمع العدد 7 مع الحرف 'a': fun main(args: ...
الحزم (Packages) في Kotlin
التصريح عن الحزم يبدأ الملف المصدريّ (source file) عادةً بالتصريح (declaration) عن الحزم مثل: package foo.bar
fun baz() {}
class Goo {}
// ...
ويتوضع حينها كلُّ ما يحتويه هذا الملف (كالأصناف [classes] والدوال [functions] مثلًا) في الحزمة المُصرَّح عنها ببدايته، ففي الشيفرة السابقة إن الاسم الفعليّ الكامل للدالة baz() هو foo.bar.baz والاسم الكامل للصنف Goo هو foo.bar.Goo. وإذا لم تُحدَّد الحزمة في بداية الملف فإن محتوياته تتبع للحزمة الافتراضيّة "default" التي لا اسم لها. استيراد الحزم الافتراضيّة (Default Imports) يُستورَد عددٌ من الحزم ...
الدالة indexOf() في Kotlin
تجلب الدالة indexOf() فهرس أول ظهور لعنصر محدَّد من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها. البنية العامة يمكن استدعاء الدالة indexOf() مع المصفوفات، والمجموعات والقوائم: fun <T> Array<out T>.indexOf(element: T): Int
fun ByteArray.indexOf(element: Byte): Int
fun ShortArray.indexOf(element: Short): Int
fun IntArray.indexOf(element: Int): Int
fun LongArray.indexOf(element: Long): Int
fun FloatArray.indexOf(element: Float): Int
fun DoubleArray.indexOf(element: Double): Int
fun BooleanArray.indexOf(element: Boolean): Int
fun CharArray.indexOf(element: Char): Int
fun <T> Iterable<T>.indexOf(element: T): Int
fun <T> List<T>.indexOf(element: T): Int
المعاملات index العنصر المراد جلب فهرس ...
الدالة Any.hashCode() في Kotlin
تعيد الدالة hashCode() الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. تُحقِّق هذه الدالة الشرطين الآتيين دائمًا: تعيد نفس العدد الصحيح دائمًا في كل مرة تستدعى فيها مع الكائن نفسه شريطة عدم تغيُّر أيّ معلومة تستخدمها الدالة equals() عند موازنة هذا الكائن مع غيره. إذا تساوى كائنان بحسب الدالة equals()، فيجب أن تعيد الدالة hashCode() شيفرة hash نفسها لكلٍّ منها. البنية العامة open fun hashCode(): Int
وجود الكلمة المفتاحيّة open هنا يدل على السماح بإعادة تعريف (override) هذه الدالة في الأصناف الفرعيّة ...
الدالة contentToString() في Kotlin
تعيد الدالة contentToString() سلسلة نصية تمثِّل محتوى المصفوفة التي استُدعيت معها كما لو كانت قائمة. البنية العامة inline fun <T> Array<out T>.contentToString(): String
inline fun ByteArray.contentToString(): String
inline fun ShortArray.contentToString(): String
inline fun IntArray.contentToString(): String
inline fun LongArray.contentToString(): String
inline fun FloatArray.contentToString(): String
inline fun DoubleArray.contentToString(): String
inline fun BooleanArray.contentToString(): String
inline fun CharArray.contentToString(): String
الإصدار المطلوب: Kotlin 1.1 وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة). القيم المعادة تُعاد سلسلة نصية تمثِّل محتوى المصفوفة المعطاة ...
الدالة Any.toString() في Kotlin
تحول الدالة toString() الكائن الذي يُستدعى معه إلى سلسلة نصية (String). البنية العامة open fun toString(): String
وجود الكلمة المفتاحيّة open هنا يدل على السماح بإعادة تعريف (override) هذه الدالة في الأصناف الفرعيّة (subclasses) للصنف Any (راجع صفحة الأصناف والوراثة للمزيد من التفاصيل). القيم المعادة تعاد سلسلة نصيّة تضم جميع محتويات الكائن المعطى. أمثلة مثال على استعمال الدالة toString() مع سلسلة نصية: fun main(args: Array<String>) {
var x = 5
println(x.toString()) // 5
}
مثالٌ آخر على استعمال الدالة toString() مع مصفوفة: import java.util.*
fun main(args: ...
الدالة toByteArray() في Kotlin
تحوِّل الدالة toByteArray() المصفوفة العامة (أي من النوع Array<Byte>) أو المجموعة التي استُدعيت معها إلى مصفوفة من النوع ByteArray. البنية العامة fun Array<out Byte>.toByteArray(): ByteArray
fun Collection<Byte>.toByteArray(): ByteArray
القيمة المعادة تعاد مصفوفة من النوع ByteArray تحوي جميع عناصر المصفوفة العامة (أي من النوع Array<Byte>) أو المجموعة المعطاة. أمثلة استعمال الدالة ()toByteArray لتحويل مصفوفة من النوع Array<Byte> إلى النوع ByteArray: import java.util.Arrays
fun main(args: Array<String>) {
val array: Array<Byte> = arrayOf(1, 5, 6)
println(array.toByteArray().javaClass.kotlin.qualifiedName) // kotlin.ByteArray
}
انظر أيضًا لدالة toBooleanArray(): تحول المصفوفة العامة (أي من النوع Array<out Boolean>) أو المجموعة التي استُدعيت معها إلى مصفوفة من القيم ...
الدالة iterator() في Kotlin
تسمح الدالة iterator() بالتكرار (iterate) على كائنٍ ديناميكيّ (dynamic) في الحالات الآتية: إن كان لديه دالة تكراريّة (iterator function). إن كان مصفوفةً (array). إن كان نسخةً (instance) من Kotlin.collections.Iterable. البنية العامة operator fun dynamic.iterator(): Iterator<dynamic>
بيئة التشغيل المطلوبة: JS. ويُلاحظ وجود الكلمة المفتاحيّة operator للدلالة على أنّ هذه الدالة مرتبطٌ بمعامل التكرار (iteration operator). انظر أيضًا الدالة ()asDynamic: تعيد قيمة الكائن الذي استدعيت عبره على شكل قيمةٍ من النوع الديناميكيّ (dynamic type). مصادر صفحة الدالة iterator() في التوثيق الرسميّ للمكتبة القياسيّة ...
الثابت Byte.MIN_VALUE في Kotlin
يمثِّل الثابت Byte.MIN_VALUE أصغر قيمة يمكن تخزينها في النوع Byte. البنية العامة const val MIN_VALUE: Byte
أمثلة استعمال الثابت Byte.MIN_VALUE لمعرفة أصغر قيمة يمكن تخزينها في النوع Byte: fun main(args: Array<String>) {
println(Byte.MIN_VALUE) // -128
}
انظر أيضًا الثابت MAX_VALUE: يمثِّل أكبر قيمة يمكن تخزينها في النوع Byte. مصادر صفحة الثابت Byte.MIN_VALUE في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.
الدالة sortByDescending() في Kotlin
ترتِّب الدالة sortByDescending() عناصر المصفوفة أو القائمة المتغيرة (MutableList) التي استُدعيت معها تنازليًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر. البنية العامة يمكن استدعاء الدالة sortByDescending() مع المصفوفات والقوائم المتغيرة: inline fun <T, R : Comparable<R>> Array<out T>.sortBy(
crossinline selector: (T) -> R?
inline fun <T, R : Comparable<R>> MutableList<T>.sortBy(
crossinline selector: (T) -> R?)
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات ...
الثابت Double.NaN في Kotlin
يمثل الثابت Double.NaN قيمة غير عددية (Not a Number) لعدد من النوع Double. البنية العامة val NaN: Float
أمثلة استعمال الثابت Float.NaN لطباعة القيمة NaN: fun main(args: Array<String>) {
println(Float.NaN) // NaN
}
انظر أيضًا الثابت Double.MAX_VALUE: يمثل أكبر قيمة موجبة نهائية (finite) لعدد عشري مضاعف (double). الثابت Double.MIN_VALUE: يمثل أًصغر قيمة موجبة غير صفرية يمكن أن يأخذها عدد عشري مضاعف (double). الثابت Double.NEGATIVE_INFINITY: يمثل قيمة سالبة لا نهائية (infinity) لعدد عشري مضاعف (double). ...
الدالة groupingBy() في Kotlin
تُنشئ الدالة groupingBy() موردًا (source) من النوع Grouping من المصفوفة أو المجموعة التي استُدعيت معها لاستخدامه لاحقًا مع عمليات التجميع (group-and-fold operations) وذلك باستخدام الدالة keySelector المُمرّرة إليها لاستخلاص مفتاح من كل عنصر. البنية العامة الإصدار المطلوب: Kotlin 1.1. يمكن استدعاء الدالة groupByTo() مع المصفوفات والمجموعات: inline fun <T, K> Array<out T>.groupingBy(
crossinline keySelector: (T) -> K
): Grouping<T, K>
inline fun <T, K> Iterable<T>.groupingBy(
crossinline keySelector: (T) -> K
): Grouping<T, K>
وجود الكلمة المفتاحية inline يدل على أنَّ هذه ...
الدالة Char.toFloat() في Kotlin
تحوّل الدالة toFloat() المحرف الذي استُدعي معها إلى عدد عشري (أي من النوع Float). البنية العامة fun toFloat(): Float
القيمة المعادة يعاد عدد عشري من النوع Float يمثل القيمة العددية للمحرف المعطى. أمثلة استعمال الدالة ()toFloat لتحويل المحرف 'a' إلى عدد عشري: fun main(args: Array<String>) {
val x = 'a'
println(x.toFloat()) // 97.0
}
انظر أيضًا الدالة toByte() : تحوّل المحرف الذي استُدعي معها إلى عدد من النوع ...
الدالة Enum.clone() في Kotlin
ترمي الدالة clone() استثناءً لأنّ ثوابت الصنف Enum لا يمكن أن تُنسَخ. تمنع هذه الدالة الأصناف ذات النوع Enum من أن ترِث من الصنف Cloneable. البنية العامة protected fun clone(): Any
أمثلة يؤدي استعمال الدالة clone() في المثال التالي إلى رمي استثناء: fun main(args: Array<String>) {
val x = ColorEnum.Red
val y = x.clone() // Error:(3, 14) Cannot access 'clone': it is protected in 'ColorEnum'
}
enum class ColorEnum(val colorCode: Int)
{
Red(2),
...
الدالة Double.toByte() في Kotlin
تحوّل الدالة toByte() العدد العشري المضاعف (double) الذي استُدعي معها إلى عدد من النوع Byte. هذا قد يؤدي إلى تدوير العدد المراد تحويله أو اقتطاع جزءٍ منه. البنية العامة fun toByte(): Byte
القيمة المعادة يعاد عدد من النوع Byte يحوي العدد العشري المضاعف المعطى. أمثلة استعمال الدالة ()toByte لتحويل عدد عشري مضاعف إلى عدد من النوع Byte: fun main(args: Array<String>) {
val x: Double = 52.43
print(x.toByte()) // 52
}
انظر أيضًا ...
الدالة toSet() في Kotlin
تحول الدالة toSet() المصفوفة أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع Set. تحافظ المجموعة المُعادة على نفس ترتيب تكرار المصفوفة أو المجموعة التكرارية الأصلية. البنية العامة يمكن استدعاء الدالة toSet() مع المصفوفات والمجموعات التكرارية: fun <T> Array<out T>.toSet(): Set<T>
fun ByteArray.toSet(): Set<Byte>
fun ShortArray.toSet(): Set<Short>
fun IntArray.toSet(): Set<Int>
fun LongArray.toSet(): Set<Long>
fun FloatArray.toSet(): Set<Float>
fun DoubleArray.toSet(): Set<Double>
fun BooleanArray.toSet(): Set<Boolean>
fun CharArray.toSet(): Set<Char>
fun <T> Iterable<T>.toSet(): Set<T>
القيمة المعادة تعاد مجموعة من النوع Set تحوي جميع عناصر المصفوفة أو المجموعة التكرارية المعطاة. أمثلة استعمال الدالة ()toSet لتحويل مصفوفة إلى مجموعة من ...
الدالة asIterable() في Kotlin
تُنشِئ الدالة asIterable()نسخةً تكراريّةً (iterable instance) تُغلّف (wrap) المصفوفة الأصلية وتعيد عناصرَها عندما تُستخدَم في حلقات التكرار (مثل for). البنية العامة fun <T> Array<out T>.asIterable(): Iterable<T>
fun ByteArray.asIterable(): Iterable<Byte>
fun ShortArray.asIterable(): Iterable<Short>
fun IntArray.asIterable(): Iterable<Int>
fun LongArray.asIterable(): Iterable<Long>
fun FloatArray.asIterable(): Iterable<Float>
fun DoubleArray.asIterable(): Iterable<Double>
fun BooleanArray.asIterable(): Iterable<Boolean>
fun CharArray.asIterable(): Iterable<Char>
ويمكن استدعاء الدالة asIterable()عبر مجموعة (collection) لتُعيدها على شكل عنصر تكراريّ (iterable): inline fun <T> Iterable<T>.asIterable(): Iterable<T>
كما ويمكن استدعاء الدالة asIterable()عبر عنصر map وستعيد نسخةً تكراريةً (iterable instance) تُغلّف عنصر map الأصلي وتعيد مداخله (entries) ...
الدالة sortedArray() في Kotlin
ترتِّب الدالة sortedArray() جميع عناصر المصفوفة التي استُدعيت معها تصاعديًّا ثمَّ تضع الناتج في مصفوفة جديدة. البنية العامة fun <T : Comparable<T>> Array<T>.sortedArray(): Array<T>
fun ByteArray.sortedArray(): ByteArray
fun ShortArray.sortedArray(): ShortArray
fun IntArray.sortedArray(): IntArray
fun LongArray.sortedArray(): LongArray
fun FloatArray.sortedArray(): FloatArray
fun DoubleArray.sortedArray(): DoubleArray
fun CharArray.sortedArray(): CharArray
القيمة المعادة تعاد مصفوفة جديدة تضم عناصر المصفوفة المعطاة بعد ترتيبها تصاعديًّا. أمثلة استعمال الدالة ()sortedArray لترتيب عناصر مصفوفة تصاعديًّا: import java.util.Arrays
fun main(args: Array<String>) {
val array = arrayOf(1, 9, -3, 7, 5, 6)
...
الدالة Byte.toByte() في Kotlin
تحوّل الدالة toByte() العدد الذي استُدعي معها إلى عدد من النوع Byte، وهذا قد يؤدي إلى تقريب العدد أو اقتطاع جزءٍ منه. البنية العامة fun toByte(): Byte
القيمة المعادة يعاد عدد من النوع Byte. أمثلة استعمال الدالة ()toByte لتحويل عدد من النوع Int إلى Byte: fun main(args: Array<String>) {
val x: Int = 52
println(x.toByte()) // 52
}
استعمال الدالة ()toByte لتحويل عدد من النوع float إلى Byte: fun main(args: Array<String>) {
val ...
الثابت Char.MAX_HIGH_SURROGATE في Kotlin
يمثِّل الثابت Char.MAX_HIGH_SURROGATE القيمة القصوى للبديل الأعلى لعدد بتات الترميز الموحد (Unicode high-surrogate code unit). البنية العامة const val MAX_HIGH_SURROGATE: Char
انظر أيضًا الثابت Char.MAX_LOW_SURROGATE: يمثل القيمة القصوى للبديل الأدنى لوحدة اليونيكود (Unicode low-surrogate code unit). الثابتةChar.MAX_SURROGATE : يمثِّل القيمة القصوى لبديل وحدة اليونيكود (Unicode surrogate code unit). الثابت Char.MIN_HIGH_SURROGATE: يمثل القيمة الدنيا للبديل الأعلى لوحدة اليونيكود (Unicode high-surrogate code unit). الثابت Char.MIN_LOW_SURROGATE : يمثل القيمة الدنيا للبديل الأدنى لوحدة اليونيكود (Unicode low-surrogate code unit). الثابت Char.MIN_SURROGATE: يمثل القيمة الدنيا لبديل وحدة ...
الدالة run() في Kotlin
يمكن استخدام الدالة run() بطريقتين: استدعاء بنية (block) الدالة المُحدَّدة وذلك بجعل قيمة this كمستقبِلٍ (receiver) له وإعادة قيمة ناتج البنية. استدعاء بنية (block) الدالة المُحدَّدة وإعادة ناتجها. البنية العام inline fun <T, R> T.run(block: T.() -> R): R
inline fun <R> run(block: () -> R): R
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions). المعاملات block الكتلة البرمجية المراد استدعاؤها وتنفيذها. القيم المعادة يعاد ناتج بنية (block) الدالة المُحدَّدة ...
الدالة any() في Kotlin
يختلف سلوك الدالة any() بحسب طريقة استدعائها، وسنناقش هذه الحالات تباعًا. حالات استدعاء الدالة any() في حال استدعاء الدالة any() مع مصفوفة (array) أو مجموعة (collection) دون تمرير أيّ معامل (parameter) لها، فستعيد القيمة true إن كانت المصفوفة أو المجموعة تحتوي على عنصر ٍ واحدٍ على الأقل (أي أنها غير فارغة)، وتعيد القيمة false بخلاف ذلك. في حال تمرير دالةٍ ما كوسيطٍ (parameter) في الدالة any() فستعيد القيمة true إن كان هناك واحدٌ على الأقل من عناصر المصفوفة أو المجموعة ...
الصنف 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() قيمة عنصر ذي ...
الدالة Any.equals() في Kotlin
تتحقق الدالة equals() إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معه. وأيُّ تعريف لاستخدام هذه الدالة يجب أن يكون: انعكاسيًا (Reflexive): لكل مرجع x لا يساوي null، يجب أن تُعيد العبارة x.equals(x) القيمة true. تماثليًَا (Symmetric): لكل قيمتين مرجعيتين x و y لا تساويان null، ستعيد العبارة x.equals (y) القيمة true إذا وفقط إذا أعادت العبارة y.equals (x) القيمة true. تواتريًا (Transitive): لكل القيم المرجعية x و y و z التي لا تساوي null، ستعيد العبارة x.equals ...
الصنف FloatArray في Kotlin
يمثل الصنف FloatArray مصفوفةً من الأعداد العشرية. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []float. class FloatArray
الدوال البانية <init> تنشئ الدالة FloatArray() البانية مصفوفة جديدة من النوع FloatArray (أي مصفوفة من الأعداد العشرية) بحجم معين، وتحوي قيمًا محدَّدة أو القيم 0. الخاصيات size تمثِّل الخاصيّة FloatArray.size عدد العناصر الموجودة في المصفوفة ذات النوع FloatArray. الدوال get تجلب الدالة get() عنصرًا ذي فهرس محدد من المصفوفة. iterator ينشئ الدالة iterator() عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set تضبط الدالة set() قيمة عنصر ذي ...
الدالة sort() في Kotlin
ترتِّب الدالة sort() المصفوفة أو القائمة المتغيرة (MutableList) التي استُدعيت معها تصاعديًّا. البنية العامة إن لم يمرَّر أي وسيط إلى الدالة sort()، فسترتِّب جميع عناصر المصفوفة أو القائمة المتغيرة التي استدعيت معها: fun IntArray.sort()
fun LongArray.sort()
fun ByteArray.sort()
fun ShortArray.sort()
fun DoubleArray.sort()
fun FloatArray.sort()
fun CharArray.sort()
inline fun <T : Comparable<T>> Array<out T>.sort() (source)
fun <T : Comparable<T>> MutableList<T>.sort()
أمَّا إن استدعيت الدالة sort() مع تمرير وسيطين عددين، فسترتِّب المجال الذي يحدده هذين الوسيطين داخل المصفوفة التي استدعيت معها (بيئة التشغيل: JVM): fun <T> ...
الثابت Char.MIN_HIGH_SURROGATE في Kotlin
يمثل الثابت Char.MIN_HIGH_SURROGATE القيمة الدنيا للبديل الأعلى لعدد بتات الترميز الموحد (Unicode high-surrogate code unit). البنية العامة const val MIN_HIGH_SURROGATE: Char
انظر أيضًا الثابت Char.MAX_HIGH_SURROGATE: يمثّل القيمة القصوى للبديل الأعلى لوحدة اليونيكود (Unicode high-surrogate code unit). الثابت Char.MAX_LOW_SURROGATE: يمثل القيمة القصوى للبديل الأدنى لوحدة اليونيكود (Unicode low-surrogate code unit). الثابت Char.MAX_SURROGATE: يمثِّل القيمة القصوى لبديل وحدة اليونيكود (Unicode surrogate code unit). الثابت Char.MIN_LOW_SURROGATE: يمثل القيمة الدنيا للبديل الأدنى لوحدة اليونيكود (Unicode low-surrogate code unit). الثابت Char.MIN_SURROGATE: يمثل القيمة الدنيا لبديل ...
الدالة Array.iterator() في Kotlin
تعيد الدالة Array.iterator() عنصرًا تكراريًّا (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة. البنية العامة operator fun iterator(): Iterator<T>
ويُلاحظ وجود الكلمة المفتاحية operator للدلالة على أنّ هذه الدالة مرتبطٌ بمعامل التكرار (iteration operator) المستخدم في شيفرة المثال اللاحق. القيم المعادة يعاد عنصرٌ تكراريٌّ (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة. أمثلة تنشِئ الشيفرة الآتية مصفوفةً من ستة أعدادٍ صحيحةٍ بالاعتماد على الدالة arrayOf ثم تخصِّص لهذه المصفوفة عنصرًا تكراريًا (iterator) باستخدام الدالة iterator() لاستخدامه في ...
الدالة Double.unaryMinus() في Kotlin
تعيد الدالة unaryMinus() القيمة السالبة المقابلة للعدد العشري المضاعف (double) الذي استُدعي معها. البنية العامة operator fun unaryMinus(): Double
وجود الكلمة المفتاحيّة operator يدل على أنّ هذه الدالة مرتبطٌة بمعامل تكرار (iteration operator). القيمة المعادة يعاد عدد عشري مضاعف يمثل القيمة السالبة للعدد العشري المضاعف المعطى. أمثلة استعمال الدالة ()unaryMinus لإعادة قيمة سالبة لعدد عشري مضاعف موجب وآخر سالب: fun main(args: Array<String>) {
val x: Double = 52.5
val y = x.unaryMinus()
println(y) // ...
الدالة reflect() في Kotlin
الدالة reflect() هي واجهة برمجية (API) تجريبية؛ إن استدعيت مع تعبير تعريف دالة (function expression) أو تعبير lambda، فستعيد نسخةً من KFunction تزودنا بالإمكانيات الداخلية (introspection capabilities) لتعبير تعريف الدالة أو تعبير lambda ذاك المعطى وعن معاملاته. ليست جميع الميزات مدعومةً في الوقت الحالي، تحديدًا KCallable.call و KCallable.callBy. البنية العامة fun <R> Function<R>.reflect(): KFunction<R>?
منصة التشغيل المطلوبة: JVM. انظر أيضًا الواجهة Function. الدوال من المرتبة الأعلى (Higher-Order Functions) و تعابير Lambdas. مصادر صفحة الدالة ()reflect في التوثيق الرسميّ للمكتبة القياسيّة في لغة ...
الصنف Function في Kotlin
تمثل الواجهة Function قيمةً لنوع وظيفي (functional type) -مثل تعبير lambda-، أو دالة مجهولة، أو مرجع دالة. interface Function<out R>
إذ يعيد المعامل R نوع الدالة. الدوال الموروثة equals تتحقق الدالة equals() إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معه. وأيُّ تعريف لاستخدام هذه الدالة يجب أن يكون: hashCode تعيد الدالة hashCode() الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. تُحقِّق هذه الدالة الشرطين الآتيين دائمًا: toString تحول الدالة toString() الكائن الذي يُستدعى معه إلى سلسلة نصية (String). الدوال الإضافية (Extension Functions) reflect ...
الدالة Byte.toLong() في Kotlin
تحول الدالة toLong() العدد الذي استُدعي معها إلى عدد من النوع Long، وهذا قد يؤدي إلى تقريب العدد أو اقتطاع جزءٍ منه. البنية العامة fun toLong(): Long
القيمة المعادة يعاد عدد من النوع Long. أمثلة استعمال الدالة ()toLong لتحويل عدد من النوع Byte إلى النوع Long: fun main(args: Array<String>) {
val x : Byte = 52
println(x.toLong() )// 52
...
الخاصية FloatArray.size في Kotlin
تمثِّل الخاصيّة FloatArray.size عدد العناصر الموجودة في المصفوفة ذات النوع FloatArray. البنية العامة val size: Int
القيم المعادة يعاد عددٌ صحيحٌ يمثِّل عدد العناصر في المصفوفة المعطاة. أمثلة استعمال الخاصيّة size لمعرفة عدد العناصر الموجود في مصفوفة من النوع FloatArray: fun main(args: Array<String>) {
val array = FloatArray(6)
print(array.size) // 6
}
انظر أيضًا الصنف FloatArray. الدالة FloatArray(): تنشئ مصفوفة جديدة من النوع FloatArray (أي مصفوفة من الأعداد العشرية) بحجم معين، وتحوي قيمًا محدَّدة أو القيم 0. الدالة ()get: تجلب عنصرًا ذي فهرس محدد من المصفوفة. الدالة iterator(): تنشئ عنصرًا ...
الدالة fold() في Kotlin
تجمع الدالة fold() تراكميًّا ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر الكائن المستدعى معها والقيمة التراكمية الحالية بالإضافة إلى قيمة أولية إن أعطيت، ويختلف سلوكها بحسب نوع الكائنات المستدعاة معها والمعاملات المُمرّرة إليها (انظر قسم "البنية العامة"). البنية العامة تجمع الدالة fold() بشكل تراكمي ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (من اليسار إلى اليمين) المستدعاة معها والقيمة التراكمية الحالية بالإضافة إلى القيمة الأولية إن أعطيت. inline fun <T, R> Array<out ...
الدالة reverse() في Kotlin
تعكس الدالة reverse() ترتيب عناصر المصفوفة أو القائمة التي استُدعيت معها. البنية العامة يمكن استدعاء الدالة reverse() مع المصفوفات: fun <T> Array<T>.reverse()
fun ByteArray.reverse()
fun ShortArray.reverse()
fun IntArray.reverse()
fun LongArray.reverse()
fun FloatArray.reverse()
fun DoubleArray.reverse()
fun BooleanArray.reverse()
fun CharArray.reverse()
ويمكن استدعاؤها مع القوائم المتغيرة (MutableList): fun <T> MutableList<T>.reverse()
أمثلة استعمال الدالة ()reverse لعكس ترتيب عناصر قائمة: fun main(args: Array<String>) {
var list = MutableList(6) { it } // [0, 1, 2, 3, 4, 5]
list.reverse()
print(list) ...
الدالة toCollection() في Kotlin
تضيف الدالة toCollection() جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها إلى المجموعة المتغيرة (MutableCollection) المُمرّرة إليها. البنية العامة fun <T, C : MutableCollection<in T>> Array<out T>.toCollection(
destination: C
): C
fun <C : MutableCollection<in Byte>> ByteArray.toCollection(
destination: C
): C
fun <C : MutableCollection<in Short>> ShortArray.toCollection(
destination: C
): C
fun <C : MutableCollection<in Int>> IntArray.toCollection(
destination: C
): C
fun <C : MutableCollection<in Long>> LongArray.toCollection(
destination: C
): ...
الدالة mapNotNullTo() في Kotlin
تشبه الدالة mapNotNullTo() الدالة mapNotNull() تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة. البنية العامة يمكن استدعاء الدالة mapNotNullTo() مع المصفوفات والمجموعات والخرائط: inline fun <T, R : Any, C : MutableCollection<in R>> Array<out T>.mapNotNullTo(
destination: C,
transform: (T) -> R?
): C
inline fun <T, R : Any, C : MutableCollection<in R>> Iterable<T>.mapNotNullTo(
destination: C,
transform: (T) -> R?
): ...
الدالة 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) // ...
الدالة 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 ...
الصنف CharDirectionality في Kotlin
الخاصيات الموروثة (Inherited Properties) name تعيد الخاصية name اسم الثابت من الكائن enum الذي استُدعيت عبره، كما سُمّيت أُثناء تعريف ذلك الكائن. ordinal تعيد الخاصية ordinal ترتيب الثابت من الكائن enum الذي استُدعيت عبره enumeration constant))، أي ترتيبها في تصريح الكائن enum،بحيث تأخذ المُركّبة الأولى العدد 0. الدوال الموروثة clone يطلق التابع clone() استثناءً (exception) لأنّ ثوابت enum لا يمكن أن تُنسخ. هذا التابع يمنع الأصناف من النوع Enum من أن ترِث من الصنفCloneable. compareTo تقارن الدالةcompareTo() بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة 0 إن كانا متساويين، أو تعيد قيمة سلبية ...
الدالة 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: ...
الدالة 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) -> ...
الدالة 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(): ...
الصنف CharCategory في Kotlin
الدوال الموروثة clone يطلق التابع clone() استثناءً (exception) لأنّ ثوابت enum لا يمكن أن تُنسخ. هذا التابع يمنع الأصناف من النوع Enum من أن ترِث من الصنفCloneable. compareTo تقارن الدالةcompareTo() بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة 0 إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة . equals تبين الدالة equals() إذا ما كان الكائن المُمرّر إليها يساوي ...
الدالة 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 = ...
الصنف BooleanArray في Kotlin
يمثل الصنف BooleanArray مصفوفةً من القيم المنطقية. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []boolean. class BooleanArray
الدوال البانية init تنشئ الدالة BooleanArray() البانية مصفوفة جديدة من الصنف BooleanArray بحجم معين تحوي قيمًا منطقية محدَّدة أو القيمة false المنطقية. الخاصيات size تمثِّل الخاصيّة size عدد العناصر الموجودة في المصفوفة. الدوال get يجلب التابع get() عنصرًا ذي فهرس محدد من المصفوفة. iterator ينشئ التابع iterator() عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set يضبط التابع set() قيمة عنصر ذي فهرس محدد موجود ...
الدالة 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 لإنشاء مجال من الأعداد ينحصر بين العدد ...
الخاصية javaClass في Kotlin
تعيد الخاصيّة javaClass صنف Java الخاص بالكائن (object) الذي تُستدعى عبره أثناء التشغيل (runtime)، وتُعرَّف هذه الخاصية في جميع الأصناف الفرعيّة (sub-classes) من الصنف Any. البنية العامة inline val <T : Any> T.javaClass: Class<T>
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions). القيم المعادة صنف Java الخاصّ بالكائن الذي تُستدعى عبره أثناء التشغيل (runtime). أمثلة تنشِئ الشيفرة الآتية سلسلةً نصيةً باسم a، وتحصل على صنف Java الخاص بها عبر استدعاء ...
الصنف Comparable في Kotlin
الأصناف التي ترث من الواجهة Comparable تملك ترتيبًا إجماليًّا مُعرَّفًا بين نُسخِها. interface Comparable<in T>
الدوال compareTo توازن الدالة compareTo() بين الكائن الذي استُدعي معها والكائن المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية. الدوال الموروثة equals تحدد الدالة equals() إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معها. hashCode تعيد الدالة hashCode() قيمة ...
الدالة indexOfFirst() في Kotlin
تجلب الدالة indexOfFirst() فهرس أول عنصر يحقِّق شرطًا معيَّنًا من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها. البنية العامة يمكن استدعاء الدالة indexOfFirst() مع المصفوفات والمجموعات والقوائم: inline fun <T> Array<out T>.indexOfFirst(
predicate: (T) -> Boolean
): Int
inline fun ByteArray.indexOfFirst(
predicate: (Byte) -> Boolean
): Int
inline fun ShortArray.indexOfFirst(
predicate: (Short) -> Boolean
): Int
inline fun IntArray.indexOfFirst(
predicate: (Int) -> Boolean
): Int
inline fun LongArray.indexOfFirst(
...
الدالة 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>) أو المجموعة التي استُدعيت معها ...
عرض (500 السابقة | 500 التالية) (20 | 50 | 100 | 250 | 500).