نتائج البحث

تجمع الدالة 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()‎ عنصرًا ذي فهرس معيَّن من المصفوفة أو المجموعة التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود المصفوفة أو المجموعة، فستُعيد الدالة ناتج استدعاء دالة معينة. البنية العامة يمكن استدعاء الدالة 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()‎ بادئة ولاحقة إلى جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها (أو جزءٍ منها) وتفصلها بفاصلة معينة ثمَّ تضيفها إلى سلسة نصية موجودة مسبقًا. إن كانت المجموعة كبيرة، فيمكن تحديد جزءٍ أولي معين منها فقط لإضافته إلى السلسلة النصية؛ في هذه الحالة، تضاف سلسلة نصية معينة، مثل "..." أو "...إلخ" إلى السلسلة النصية الناتجة للدلالة على وجود جزء مقتطع. البنية العامة fun <T, A> Array<out T>.joinTo( buffer: A, separator: CharSequence ...

تمثل الواجهة CharSequence سلسلةً من المحارف قابلةً للقراءة. interface CharSequence الخاصيات length تمثل الخاصية CharSequence.length عدد عناصر سلسلة المحارف (CharSequence) المستدعاة معها. الدوال get تجلب الدالة get()‎‎ المحرف ذا الفهرس الممرَّر إليها من سلسلة المحارف المستدعاة معها. subSequence تجلب الدالة subSequence()‎‎ جزءًا محددًا يقع في سلسلة المحارف التي استٌدعيت معها. الدوال الموروثة (Inherited Functions) equals تتحقق الدالة equals()‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معه.  hashCode تعيد الدالة hashCode()‎ الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. toString تحول الدالة toString()‎ الكائن الذي يُستدعى معه إلى سلسلة نصية (String). الخاصيات الإضافية (Extension Properties) ...

تسمح الدالة 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()‎ أزواجًا من عناصر كائنين لها نفس الفهرس، أو تنشئ قيمًا عبر تمرير عناصر لها نفس الفهرس تجلب من كائنين مختلفين إلى دالة معينة. البنية العامة إن استدعيت الدالة zip()‎ مع مصفوفة ومع تمرير مصفوفة أخرى إليها كوسيط، فستشكل أزواجًا من عناصر هاتين المصفوفتين التي لها نفس الفهرس وتضعها في قائمة؛ طول القائمة المعادة يساوي طول أٌقصرهما. infix fun <T, R> Array<out T>.zip( other: Array<out R> ): List<Pair<T, R>> infix fun <R> ByteArray.zip( ...

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

تحوِّل الدالة 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، وهذا قد يؤدي إلى تقريب العدد أو اقتطاع جزءٍ ...

تحوّل الدالة 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()‎ قائمةً تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء العناصر الأولى التي تحقق شرطًا معيَّنًا. البنية العامة 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()‎ آخر 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()‎ قائمةً تضم ناتج تطبيق الدالة المُمرّرة إليها على عناصر المصفوفة، أو المجموعة، أو الخريطة التي استُدعيت معها. البنية العامة يمكن استدعاء الدالة 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 ...

تعرّف أسماء لرموز اليونيكود المستخدمة في الطباعة الخاصة. الدوال الموروثة equals تبين الدالة equals()‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت عبره. hashCode يعيد التابع hashCode()‎ قيمة الشيفرة hash code الخاصّة بالكائن الذي استُدعي عبره. toString يعيد التابع toString()‎ تمثيلًا نصيًا للكائن الذي يُستدعى عبره.

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

تحوِّل الدالة toShort()‎ العدد الذي استُدعي معها إلى عدد من النوع Short، وهذا قد يؤدي إلى تقريب العدد أو اقتطاع جزءٍ منه. البنية العامة fun toShort(): Short القيمة المعادة يعاد عدد من النوع Short. أمثلة استعمال الدالة ()toShort لتحويل عدد من النوع Byte إلى النوع Short: fun main(args: Array<String>) { val x: Byte = 52 println(x.toShort()) // 52 ...

يمثل الصنف CharArray مصفوفةً من المحارف. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []char. class CharArray الدوال البانية <init> تنشئ الدالة CharArray()‎ البانية مصفوفة جديدة من النوع CharArray (أي مصفوفة من الحروف) بحجم معين، وتحوي قيمًا محدَّدة أو القيمة '‎\u0000' التي تمثل حرفًا عدميًّا. الخاصيات size تمثِّل الخاصيّة CharArray.size عدد العناصر الموجودة في المصفوفة ذات النوع CharArray. الدوال get يجلب التابع get()‎ عنصرًا ذي فهرس محدد من المصفوفة. iterator تنشئ الدالة iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set تضبط الدالة set()‎ قيمة عنصر ذي فهرس ...

تحول الدالة 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: ...

تجلب الدالة 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 اسم الثابت المعرف في الكائن 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()‎ المصفوفة العامة (أي من النوع 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] ...

تتحقق الدالة 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)‎ و ...

تمديد للصنف java.lang.Appendable.

تمثِّل الخاصيّة 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()‎ محتوى المصفوفة التي استُدعيت معها كما لو كانت قائمة إلى شيفرة 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()‎ جميع نواتج تطبيق دالة معيَّنة على كل عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها. الفرق بين الدالة 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 مستويات تصف درجات الإهمال (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()‎ مجالًا (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()‎ الكائن (object) الذي استُدعي معها إن كان ذلك الكائن يحقق شرطًا معيّنًا، أو تعيد القيمة null بخلاف ذلك. البنية العامة inline fun <T> T.takeIf(predicate: (T) -> Boolean): T? يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions). المعاملات predicate دالةٌ تطبق على كل كائن من الكائنات المعطاة وتعيد قيمة منطقية مقابلة لكلٍّ منها. القيم المعادة الكائن الذي استُدعيت الدالة معها إن كان ذلك الكائن يحقق الشرط prediacte، ...

ترتِّب الدالة 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()‎ العنصر أو الزوج الأول من المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها والذي له أصغر قيمة بحسب الموازن 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 القيمة الدنيا للبديل الأدنى لعدد بتات الترميز الموحد (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: يمثل القيمة الدنيا لبديل ...

تحوّل الدالة toLong()‎ المحرف الذي استُدعي معه إلى عدد من النوع Long. البنية العامة fun toLong(): Long القيمة المعادة يعاد عدد من النوع Long يمثِّل القيمة العددية للمحرف المعطى. أمثلة استعمال الدالة ()toLong لتحويل المحرف 'a' إلى عدد من النوع Long: fun main(args: Array<String>) { val x = 'a' print(x.toLong()) // 97 } انظر أيضًا الدالة toByte()‎ : تحوّل المحرف الذي استُدعي معها إلى عدد من النوع Byte. ...

يمثل الصنف CharArray مصفوفةً من المحارف. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []char. class CharArray الدوال البانية <init> تنشئ الدالة CharArray()‎ البانية مصفوفة جديدة من النوع CharArray (أي مصفوفة من الحروف) بحجم معين، وتحوي قيمًا محدَّدة أو القيمة '‎\u0000' التي تمثل حرفًا عدميًّا. الخاصيات size تمثِّل الخاصيّة CharArray.size عدد العناصر الموجودة في المصفوفة ذات النوع CharArray. الدوال get يجلب التابع get()‎ عنصرًا ذي فهرس محدد من المصفوفة. iterator تنشئ الدالة iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set تضبط الدالة set()‎ قيمة عنصر ذي فهرس ...

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

تمديد للصنف java.util.regex.Pattern.

تجمع الدالة 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()‎ نسخةً (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 والتي تُغلّف المجموعة التي استُدعيت عبرها وتعيد عناصرها عندما تُستخدَم ...

تطرح الدالة 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 عددًا عشريًّا مضاعفًا (دقة مضاعفة للأعداد بعد الفاصلة [double-precision floating point]) بحجم 64 بت مطابقًا للمعيار IEEE 754. في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثَّل كقيم للنوع double الأساسي. class Double : Number, Comparable<Double> الدوال compareTo توازن الدالة compareTo()‎ بين عدد عشري مضاعف (double) وعدد آخر ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كان العدد الأول (العدد الذي استُدعي مع الدالة) أصغر من العدد الثاني الممرر إليها، أو قيمة موجبة إن كان العدد الأول أكبر ...

تعيد الدالة 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()‎ قيمة جديدة معطاة مكان عناصر محدَّدة في المصفوفة أو القائمة التي تستدعى معها. البنية العامة يمكن استدعاء الدالة 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()‎ عناصر المصفوفة أو المجموعة المعطاة بناءً على فهرس العنصر وقيمته. البنية العامة 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()‎ جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها تنازليًّا ثمَّ تضع الناتج في قائمة. البنية العامة 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, ...

تنقص الدالة 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 } ...

يجلب التابع 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()‎ قائمةً تحوي عناصر المصفوفة أو المجموعة التي لم تحقق شرطًا منطقيًّا محدَّدًا. إن استدعيت مع خريطة (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> ...

تجمع الدالة plus()‎ القيمة العددية الممرَّرة إليها مع القيمة العددية للمحرف المستدعى معها ثمَّ تعيد المحرف الذي يقابل القيمة الناتجة. البنية العامة operator fun plus(other: Int): Char وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other عدد صحيح يراد جمعه مع القيمة العددية للمحرف المعطى. القيمة المعادة يعاد المحرف الذي قيمته العددية هي حاصل جمع القيمة العددية other الصحيحة مع القيمة العددية للمحرف المعطى. أمثلة استعمال الدالة ()plus لجمع العدد 7 مع الحرف 'a': fun main(args: ...

التصريح عن الحزم يبدأ الملف المصدريّ (source file) عادةً بالتصريح (declaration) عن الحزم مثل: package foo.bar fun baz() {} class Goo {} // ... ويتوضع حينها كلُّ ما يحتويه هذا الملف (كالأصناف [classes] والدوال [functions] مثلًا) في الحزمة المُصرَّح عنها ببدايته، ففي الشيفرة السابقة إن الاسم الفعليّ الكامل للدالة baz()‎ هو foo.bar.baz والاسم الكامل للصنف Goo هو foo.bar.Goo. وإذا لم تُحدَّد الحزمة في بداية الملف فإن محتوياته تتبع للحزمة الافتراضيّة "default" التي لا اسم لها. استيراد الحزم الافتراضيّة (Default Imports) يُستورَد عددٌ من الحزم ...

تجلب الدالة 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 العنصر المراد جلب فهرس ...

تعيد الدالة hashCode()‎ الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. تُحقِّق هذه الدالة الشرطين الآتيين دائمًا: تعيد نفس العدد الصحيح دائمًا في كل مرة تستدعى فيها مع الكائن نفسه شريطة عدم تغيُّر أيّ معلومة تستخدمها الدالة equals()‎ عند موازنة هذا الكائن مع غيره. إذا تساوى كائنان بحسب الدالة equals()‎، فيجب أن تعيد الدالة hashCode()‎ شيفرة hash نفسها لكلٍّ منها. البنية العامة open fun hashCode(): Int وجود الكلمة المفتاحيّة open هنا يدل على السماح بإعادة تعريف (override) هذه الدالة في الأصناف الفرعيّة ...