نتائج البحث

اذهب إلى التنقل اذهب إلى البحث

الدالة copyOfRange()‎ في Kotlin

تنسخ الدالة copyOfRange()‎ مجالًا محدَّدًا من المصفوفة التي استُدعيت معها. البنية العامة inline fun <T> Array<T>.copyOfRange( fromIndex: Int, toIndex: Int ): Array<T> inline fun ByteArray.copyOfRange( fromIndex: Int, toIndex: Int ): ByteArray inline fun ShortArray.copyOfRange( fromIndex: Int, toIndex: Int ): ShortArray inline fun IntArray.copyOfRange( fromIndex: Int, toIndex: Int ): IntArray inline fun LongArray.copyOfRange( fromIndex: ...

الدالة Float.dec()‎ في Kotlin

تنقص الدالة dec()‎ العدد العشري (float) الذي استُدعي معها بمقدار 1 ثمَّ تعيد القيمة الناتجة. البنية العامة operator fun dec(): Float وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). القيمة المعادة تعاد قيمة من النوع Float تمثل القيمة المعطاة بعد انقاصها بمقدار 1. أمثلة استعمال الدالة ()dec لإنقاص عدد عشري بمقدار 1 فقط: fun main(args: Array<String>) { val x: Float = 3.4f println(x.dec()) // 2.4 } انظر أيضًا ...

الدالة Byte.toChar()‎ في Kotlin

تحول الدالة toChar()‎ القيمة العددية للكائن الذي استُدعي معها إلى الحرف المقابل في جدول ASCII، ويمكن تقطيعه إلى 16 بت إن كان ذلك ضروريًا. البنية العامة fun toChar(): Char القيمة المعادة يعاد الحرف المقابل للقيمة العددية المعطاة. أمثلة استعمال الدالة ()toChar لتحويل قيم عددية إلى ما يقابلها من أحرف: fun main(args: Array<String>) { val x: Byte = 97 val y: Byte = 50 val z: Byte = ...

الدالة CharSequence.foldRightIndexed()‎ في Kotlin

تجمِّع الدالة foldRightIndexed()‎ تراكميًّا ناتج تطبيق عملية معينة على فهرس كل محرف من محارف السلسلة المستدعاة معها (بدءًا من اليمين إلى اليسار) وقيمته والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت. البنية العامة inline fun <R> CharSequence.foldRightIndexed( initial: R, operation: (index: Int, Char, acc: R) -> R ): R وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات initial قيمة أولية يراد إضافتها مع ناتج تطبيق الدالة operation على أول ...

الدالة substring()‎ في Kotlin

تعيد الدالة substring()‎ جزءًا محددًا من السلسلة النصية أو سلسلة المحارف التي استُدعيت معها. البنية العامة inline actual fun String.substring(startIndex: Int): String inline actual fun String.substring( startIndex: Int, endIndex: Int ): String fun String.substring(range: IntRange): String fun CharSequence.substring(range: IntRange): String inline fun CharSequence.substring( startIndex: Int, endIndex: Int = length ): String وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات startIndex عدد صحيح ...

الدالة CharSequence.associateByTo()‎ في Kotlin

تشبه الدالة associateByTo()‎ الدالة associateBy()‎ تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا. البنية العامة inline fun <K, M : MutableMap<in K, in Char>> CharSequence.associateByTo( destination: M, keySelector: (Char) -> K ): M inline fun <K, V, M : MutableMap<in K, in V>> CharSequence.associateByTo( destination: M, keySelector: (Char) -> K, valueTransform: (Char) -> V ): M وجود الكلمة المفتاحية inline يدل على أن هذه الدالة ...

الدالة Regex.replaceFirst()‎ في Kotlin

تبدل الدالة replaceFirst()‎ سلسلة النصية معينة مكان أول مطابقة للتعبير النمطي الذي استدعي معها في سلسلة المحارف المُمرّرة إليها. البنية العامة actual fun replaceFirst( input: CharSequence, replacement: String ): String المعاملات input سلسلة المحارف المراد مطابقتها مع تعبير نمطي واستبدال محتوى المعامل replacement بأول مطابقة لها. replacement السلسلة النصية التي يراد أن تحل مكان المطابقة الأولى للتعبير النمطي المعطى في المعامل input. القيمة المعادة تعاد سلسلة نصية تحوي جميع محتوى المعامل input بعد تبديل السلسلة النصية replacement ...

الدالة isIdentifierIgnorable()‎ في Kotlin

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

الصنف ‎‎Float‎ في Kotlin

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

الدالة toBigDecimal()‎ في Kotlin

تحلّل الدالة toBigDecimal()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد من النوع BigDecimal. البنية العامة inline fun String.toBigDecimal(): BigDecimal منصة التشغيل والإصدار المطلوبان: Kotlin 1.2 ، JVM. تحلّل الدالة toBigDecimal()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد من النوع java.math.BigDecimal ثم تعيد الناتج. إن لم تكن السلسلة النصية تمثل عددًا، فسيُطلَق الاستثناء NumberFormatException. inline fun String.toBigDecimal( mathContext: MathContext ): BigDecimal منصة التشغيل والإصدار المطلوبان: Kotlin 1.2 ، JVM. تحلّل الدالة toBigDecimal()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى ...

الدالة CharSequence.repeat()‎ في Kotlin

تكرِّر الدالة repeat()‎ سلسلة المحارف التي استٌدعيت معها عددًا محددًا من المرات. البنية العامة actual fun CharSequence.repeat(n: Int): String المعاملات n عدد صحيح يمثل عدد مرات تكرار سلسلة المحارف المعطاة. إن أعطيت قيمة سالبة لهذا المعامل، فسيُطلَق الاستثناء IllegalArgumentException. القيم المعادة تعاد سلسلة من المحارف تحوي جميع محارف السلسلة المعطاة بعد تكرارها n مرة. أمثلة مثالٌ على استعمال الدالة ()repeat: fun main(args: Array<String>) { println("Word".repeat(4)) // WordWordWordWord println("Word".repeat(0)) // } مثالٌ آخر على استعمال الدالة ()repeat ...

الدالة toHashSet()‎ في Kotlin

تعيد الدالة toHashSet()‎ كائنًا من النوع HashSet لجميع عناصر المصفوفة أو المجموعة التي استُدعيت معها. البنية العامة fun <T> Array<out T>.toHashSet(): HashSet<T> fun ByteArray.toHashSet(): HashSet<Byte> fun ShortArray.toHashSet(): HashSet<Short> fun IntArray.toHashSet(): HashSet<Int> fun LongArray.toHashSet(): HashSet<Long> fun FloatArray.toHashSet(): HashSet<Float> fun DoubleArray.toHashSet(): HashSet<Double> fun BooleanArray.toHashSet(): HashSet<Boolean> fun CharArray.toHashSet(): HashSet<Char> fun <T> Iterable<T>.toHashSet(): HashSet<T> القيمة المعادة يعاد كائن من النوع HashSet لجميع عناصر المصفوفة أو المجموعة المعطاة. أمثلة استعمال الدالة ()toHashSet مع مصفوفة مؤلفة من ستة عناصر: import java.util.Arrays fun main(args: Array<String>) { ...

الدالة CharSequence.singleOrNull()‎ في Kotlin

تتحقَّق الدالة singleOrNull()‎ من حواية سلسلة المحارف التي استُدعيت معها محرفًا واحدًا فقط أو محرفًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده، أو تعيد القيمة null خلاف ذلك.   البنية العامة fun CharSequence.singleOrNull(): Char? inline fun CharSequence.singleOrNull( predicate: (Char) -> Boolean ): Char? وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات predicate دالة تطبق على كل محرف من محارف السلسلة المعطاة. يمرر إليها محرفٌ وتعيد قيمة منطقية مقابله له. القيم المعادة يعاد المحرف الوحيد الموجود في سلسلة المحارف المعطاة، ...

الدالة Double.compareTo()‎ في Kotlin

توازن الدالة compareTo()‎ بين عدد عشري مضاعف (double) وعدد آخر ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كان العدد الأول (العدد الذي استُدعي مع الدالة) أصغر من العدد الثاني الممرر إليها، أو قيمة موجبة إن كان العدد الأول أكبر من العدد الثاني. استُبدِل بهذه الدالة الدالة Comparable.compareTo()‎. البنية العامة operator fun compareTo(other: Byte): Int (source) operator fun compareTo(other: Short): Int (source) operator fun compareTo(other: Int): Int (source) operator fun compareTo(other: Long): Int (source) operator fun compareTo(other: Float): Int (source) operator fun compareTo(other: Double): ...

الدالة CharSequence.mapNotNull()‎ في Kotlin

تعيد الدالة mapNotNull()‎ قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف السلسلة التي استُدعيت معها باستثناء القيم العدميَّة null التي تعيدها تلك الدالة. البنية العامة inline fun <R : Any> CharSequence.mapNotNull( transform: (Char) -> R? ): List<R> وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة (inline functions)). المعاملات transform دالةٌ تطبق على كل محرف من محارف السلسلة المعطاة. يمرر إليها محرفٌ وتعيد القيمة المقابلة له. القيم المعادة تُعاد قائمةٌ تضم ناتج تطبيق الدالة transform‎ المعطاة على كل عنصر من ...

الدالة Byte.compareTo()‎ في Kotlin

توازن الدالة compareTo()‎ بين قيمة العنصر الذي استُدعي معها والقيمة المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية. البنية العامة operator fun compareTo(other: Byte): Int حلت الدالة Comparable.compareTo()‎ مكان الشكل السابق من هذه الدالة. operator fun compareTo(other: Short): Int operator fun compareTo(other: Int): Int operator fun compareTo(other: Long): Int operator fun compareTo(other: Float): Int operator ...

الدالة withIndex()‎ في Kotlin

تعيد الدالة withIndex()‎ مجموعة تكرارية خاملة (lazy Iterable) من القيم المُفهرسة لكل محرف من محارف السلسلة التي استُدعيت معها. البنية العامة fun CharSequence.withIndex(): Iterable<IndexedValue<Char>> القيم المعادة تعاد مجموعة تكرارية خاملة (lazy Iterable) من القيم المُفهرسة لكل محرف من محارف السلسلة المعطاة. أمثلة مثالٌ على استعمال الدالة ()withIndex مع سلسلة نصية ثم إسناد الناتج الذي تعيده إلى المتغير iter، لاستخدامه في حلقة تكرارية for: fun main(args: Array<String>) { val iter = "hsoub".withIndex() for (x in iter) println(x) // المخرجات ...

الصنف ‎‎BooleanArray‎ في Kotlin

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

الصنف ‎‎Float‎ في Kotlin

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

الدالة Float.plus()‎ في Kotlin

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

الدالة last()‎ في Kotlin

تجلب الدالة last()‎ آخر عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها إن لم يمرر إليها أي شيء، أو آخر عنصر يحق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها. إن كانت المصفوفة أو المجموعة التي استُدعيت الدالة first()‎ عبرها فارغة أو لم يكن هناك أي عنصر يحقق الدالة المنطقية الممرَّرة إليها، فستُطلِق الدالة الاستثناءNoSuchElementException. البنية العامة يمكن استدعاء الدالة last()‎ مع المصفوفات بدون تمرير أية معاملات: fun <T> Array<out T>.last(): T fun ByteArray.last(): Byte fun ShortArray.last(): Short fun IntArray.last(): Int fun LongArray.last(): Long fun FloatArray.last(): Float fun DoubleArray.last(): Double fun BooleanArray.last(): Boolean ...

الصنف Boolean في Kotlin

يمثل الصنف Boolean قيمة منطقية وهي إما true أو false؛ في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثَّل كقيم للنوع boolean الأساسي. class Boolean : Comparable<Boolean> الدوال and تجري الدالة and()‎ العملية and المنطقية بين قيمتين منطقيتين؛ خلافًا للمعامل &&، تتحقق هذه الدالة من كلا القيمتين المنطقيتين. compareTo توازن الدالة compareTo()‎ بين قيمة العنصر الذي استُدعيت معه والقيمة المُمرّرة إليه ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة ...

الدالة associateTo()‎ في Kotlin

تشبه الدالة associateTo()‎ الدالة associate()‎ تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا.   البنية العامة inline fun <T, K, V, M : MutableMap<in K, in V>> Array<out T>.associateTo( destination: M, transform: (T) -> Pair<K, V> ): M inline fun <K, V, M : MutableMap<in K, in V>> ByteArray.associateTo( destination: M, transform: (Byte) -> Pair<K, V> ): M inline fun <K, V, M : MutableMap<in K, in ...

الخاصية ‎‎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 في ...

الدالة filterNot()‎ في Kotlin

ترشِّح الدالة filterNot()‎ محارف سلسلة المحارف أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي لم تحقِّق شرطًا معيَّنًا. البنية العامة inline fun CharSequence.filterNot( predicate: (Char) -> Boolean ): CharSequence inline fun String.filterNot( predicate: (Char) -> Boolean ): String وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (لمزيد من التفاصيل، راجع توثيق الدوال المباشرة). المعاملات predicate دالةٌ تمثل الشرط المراد تطبيقه على كل محرف من محارف سلسلة المحارف أو السلسلة النصية المعطاة. يمرر إلى هذه الدالة محرفٌ وتعيد قيمة منطقية. القيم المعادة ...

الدالة CharSequence.mapNotNullTo()‎ في Kotlin

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

الدالة MatchGroupCollection.get()‎ في Kotlin

تعيد الدالة get()‎ نسخةً من الصنف MatchGroup إن كانت المجموعة التي تحمل الاسم المُمرّر إليها متطابقَة. إن لم يكن جلب المجموعات المتطابقة المُسماة (named groups) مدعومًا، فسيُطلَق الاستثناء UnsupportedOperationException. البنية العامة operator fun MatchGroupCollection.get( name: String ): MatchGroup? الإصدار ومنصة التشغيل المطلوبان: JRE8 ،JVM ،Kotlin 1.2 وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). القيم المعادة تعاد نسخة من الصنف MatchGroup إن كانت المجموعة التي تحمل الاسم name متطابقَةأو تعاد القيمة null خلاف ...

الدالة CharSequence.elementAt()‎ في Kotlin

تجلب الدالة elementAt()‎ محرفًا ذي فهرس معيَّن من سلسلة المحارف التي استُدعيت معها. إن كان فهرس المحرف المعطى خارج حدود سلسلة المحارف، فستُطلق الدالة الاستثناءIndexOutOfBoundsException. البنية العامة inline fun CharSequence.elementAt(index: Int): Char وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (لمزيد من التفاصيل، راجع توثيق الدوال المباشرة). المعاملات index عدد صحيح يمثل فهرس المحرف المراد جلبه من سلسلة المحارف المعطاة. القيم المعادة يُعاد المحرف ذي الفهرس المعطى والموجود ضمن نطاق سلسلة المحارف المعطاة، أو يُطلَق الاستثناء IndexOutOfBoundsException إن كان فهرس العنصر المعطى يقع خارج حدود سلسلة المحارف. أمثلة مثالٌ على استعمال الدالة ...

الدالة replaceIndentByMargin()‎ في Kotlin

تبدِّل الدالة replaceIndentByMargin()‎ سلسلة نصية جديدة مكان المسافة البادئة (indent) المحددة في المعامل الممرر إليها في السلسلة النصية التي استُدعيت معها. البنية العامة fun String.replaceIndentByMargin( newIndent: String = "", marginPrefix: String = "|" ): String المعاملات newIndent السلسلة النصية التي يراد أن تحل مكان المسافة الفارغة البادئة. القيمة الافتراضية هي: "". marginPrefix  سلسلة نصية غير فارغة تستعمل كمحدد لحدود المسافة البادئة المراد استبدالها. القيمة الافتراضية هي: | (محرف الأنبوب [pipe character]). القيم المعادة تعاد ...

الدالة Byte.toDouble()‎ في Kotlin

تحول الدالة toDouble()‎ العدد الذي استُدعي معها إلى عدد من النوع Double، وهذا قد يؤدي إلى تقريب العدد. البنية العامة fun toDouble(): Double القيمة المعادة يعاد عدد من النوع Double. أمثلة تعرّف الشيفرة الآتية عددًا باسم x، ثم تستخدم الدالة()toDouble على x، ثم تطبع الناتج: fun main(args: Array<String>) { val x: Byte = 52 println(x.toDouble()) // 52.0 } انظر أيضًا الدالة toByte()‎: تحوّل العدد الذي استُدعي معها إلى عدد من النوع Byte، وهذا قد يؤدي إلى تقريب العدد أو اقتطاع جزءٍ ...

الدالة Regex.toPattern()‎ في Kotlin

تحول الدالة toPattern()‎ كائنًا من النوع Regex (تعبيرًا نمطيًا) إلى النوع Pattern (نمط). بناءً على ذلك، توفر هذه الدالة وسيلة لاستعمال الكائن Regex في المكان الذي يطلب فيه استعمال الكائن Pattern. البنية العامة fun toPattern(): Pattern المنصة المطلوبة: JVM. القيمة المعادة تعاد نسخةٌ من الصنف Pattern لها نفس السلسلة النصية النمطية (pattern string) والخيارات التي يملكها التعبير النمطي المعطى. أمثلة ينشِئ التابع Regex()‎ في الشيفرة التالية تعبيرًا نمطيًا باسم reg لمطابقة القيم العددية، ثم يُستدعَى معه الدالة toPattern()‎ لتحويل ذلك التعبير النمطي إلى النمط Pattern: fun main(args: Array<String>) ...

الدالة isSurrogate()‎ في Kotlin

تتحقق الدالة isSurrogate()‎ إن كان المحرف الذي استٌدعي معها بديلًا لعدد بتات الترميز الموحد (Unicode surrogate code unit). البنية العامة fun Char.isSurrogate(): Boolean وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة المنطقية true إن كان المحرف الذي استٌدعي معها بديلًا لعدد بتات الترميز الموحد، أو القيمة false خلاف ذلك. أمثلة استعمال الدالة isSurrogate()‎ لمعرفة أي المحرفيين التاليين هو بديل لعدد بتات الترميز الموحد: fun main(args: Array<String>) { ...

الخاصية BooleanArray.size في Kotlin

تمثِّل الخاصيّة size عدد العناصر الموجودة في المصفوفة. البنية العامة val size: Int القيم المعادة يعاد عددٌ صحيحٌ يمثِّل عدد العناصر في المصفوفة المعطاة. أمثلة استعمال الخاصية size مع مصفوفة منطقية يراد معرفة عدد عناصرها: fun main(args: Array<String>) { val array = BooleanArray(4) {it % 2 == 0} println(array.size) // 4 } استعمال الخاصية size لمعرفة إن كانت المصفوفة فارغة أم لا: fun main(args: Array<String>) { ...

الدالة find()‎ في Kotlin

تبحث الدالة find()‎ على عنصر محدَّد ضمن عناصر المصفوفة أو المجموعة التي استُدعيت معها ثمَّ تعيد أول ظهور له. البنية العامة inline fun <T> Array<out T>.find( predicate: (T) -> Boolean ): T? inline fun ByteArray.find( predicate: (Byte) -> Boolean ): Byte? inline fun ShortArray.find( predicate: (Short) -> Boolean ): Short? inline fun IntArray.find(predicate: (Int) -> Boolean): Int? (source) inline fun LongArray.find( predicate: (Long) -> Boolean ): Long? inline fun FloatArray.find( ...

الخاصية ‎‎Array.size في Kotlin

تمثل الخاصيّة size‎ عدد العناصر الموجودة في المصفوفة (array). البنية العامة val size: Int القيم المعادة يعاد عددٌ صحيحٌ يساوي عدد العناصر في المصفوفة المُحدَّدة. أمثلة استخدام الخاصية size مع مصفوفة أعداد صحيحة (integers): fun main(args: Array<String>) {    val arrayOfInt = arrayOf(1, 2, 3, 4, 5)    println(arrayOfInt.size)   // 5 } استخدام الخاصية size مع مصفوفة سلاسل نصية (strings): fun main(args: Array<String>) {    val arrayOfStr = arrayOf("programming","kotlin")    println(arrayOfStr.size)   // 2 } استخدام الخاصية size مع مصفوفة فارغة (empty): fun main(args: Array<String>) {    val emptyArray: Array<Int> = arrayOf()    println(emptyArray.size)  // 0 } انظر ...

الثابت Double.MAX_VALUE في Kotlin

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

الدالة ‎‎takeUnless()‎ في Kotlin

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

الدالة filter()‎ في Kotlin

ترشِّح الدالة filter()‎ محارف سلسلة المحارف أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي تحقِّق شرطًا معيَّنًا. البنية العامة inline fun CharSequence.filter( predicate: (Char) -> Boolean ): CharSequence inline fun String.filter( predicate: (Char) -> Boolean ): String وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (لمزيد من التفاصيل، راجع توثيق الدوال المباشرة). المعاملات predicate دالةٌ تمثل الشرط المراد تطبيقه على كل محرف من محارف السلسلة النصية أو سلسلة المحارف المعطاة. يمرر إلى هذه الدالة محرفٌ وتعيد قيمة منطقية. القيم المعادة تُعاد سلسلة ...

الدالة ‎‎let()‎ في Kotlin

تستدعي الدالة let()‎ بنية (block) الدالة المُحدَّدة وذلك بجعل قيمة this كوسيط (argument) لها وتعيد ناتج التنفيذ. عادة ما تُُستخدم let()‎لمنع الوصول إلى  المتغيرات في مجال الأسماء (namespace) إذ إنّ كل المتغيرات المعرَّفة داخلها لن تكون متاحةً خارج تلك البنية (block). البنية العامة inline fun <T, R> T.let(block: (T) -> R): R يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions). المعاملات block الكتلة البرمجية المراد استدعاؤها وتنفيذها. القيم المعادة ...

الدالة orEmpty()‎ في Kotlin

تعيد الدالة orEmpty()‎ المصفوفة أو المجموعة أو القائمة أو الخريطة التي استُدعيت معها إن لم تكن مساويةً للقيمة null، أو تعيد كائنًا فارغًا يقابل الكائن المعطى (مصفوفة فارغة، أو مجموعة فارغة ...إلخ.) خلاف ذلك. البنية العامة يمكن استدعاء الدالة orEmpty()‎ مع المصفوفات والمجموعات والقوائم والخرائط والمجموعات التي من النوع Set: inline fun <reified T> Array<out T>?.orEmpty(): Array<out T> inline fun <T> Collection<T>?.orEmpty(): Collection<T> inline fun <T> List<T>?.orEmpty(): List<T> inline fun <K, V> Map<K, V>?.orEmpty(): Map<K, V> (source) inline fun <K, V> Map<K, V>?.orEmpty(): Map<K, V> ...

الدالة Char.toInt()‎ في Kotlin

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

الدالة take()‎ في Kotlin

تجلب الدالة take()‎ أول n عنصر من المصفوفة أو المجموعة التكرارية التي استُدعيت معها وتضعها في قائمة. البنية العامة fun <T> Array<out T>.take(n: Int): List<T> fun ByteArray.take(n: Int): List<Byte> fun ShortArray.take(n: Int): List<Short> fun IntArray.take(n: Int): List<Int> fun LongArray.take(n: Int): List<Long> fun FloatArray.take(n: Int): List<Float> fun DoubleArray.take(n: Int): List<Double> fun BooleanArray.take(n: Int): List<Boolean> fun CharArray.take(n: Int): List<Char> fun <T> Iterable<T>.take(n: Int): List<T> المعاملات n عدد صحيح يمثل عدد العناصر الأولى المراد جلبها من المصفوفة أو المجموعة التكرارية المعطاة. إن كانت القيمة المعطاة لهذا المعامل ...

الدالة Double.div()‎ في Kotlin

تقسِّم الدالة div()‎ العدد العشري المضاعف (double) الذي استُدعي معها على العدد الممرّر إليها ثم تعيد الناتج. البنية العامة operator fun div(other: Byte): Double operator fun div(other: Short): Double operator fun div(other: Int): Double operator fun div(other: Long): Double operator fun div(other: Float): Double operator fun div(other: Double): Double وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other العدد الآخر الذي ستجرى عليه العملية. القيمة المعادة يعاد عدد عشري مضاعف ناتج قسمة العدد العدد العشري المضاعف المعطى على العدد other ...

الدالة flatMapTo()‎ في Kotlin

تشبه الدالة flatMapTo()‎ الدالة flatMap()‎ تمامًا باستثناء أنها تضيف الناتج المعاد إلى كائن موجود مسبقًا بدلًا من إعادته فقط. البنية العامة يمكن استدعاء الدالة flatMapTo()‎ مع المصفوفات: inline fun <T, R, C : MutableCollection<in R>> Array<out T>.flatMapTo( destination: C, transform: (T) -> Iterable<R> ): C inline fun <R, C : MutableCollection<in R>> ByteArray.flatMapTo( destination: C, transform: (Byte) -> Iterable<R> ): C inline fun <R, C : MutableCollection<in R>> ShortArray.flatMapTo( ...

الدالة filterNotTo()‎ في Kotlin

تشبه الدالة filterNotTo()‎ الدالة filterNot()‎ تمامًا باستثناء أنها تضيف الناتج إلى كائن موجود مسبقًا بدلًا من أن تعيده. البنية العامة inline fun <C> CharSequence.filterNotTo( destination: C, predicate: (Char) -> Boolean ): C وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (لمزيد من التفاصيل، راجع توثيق الدوال المباشرة). المعاملات destination كائن موجود مسبقًا يمثل الوجهة المراد إضافة الناتج فيها. predicate دالةٌ تمثل الشرط المراد تطبيقه على كل محرف من محارف سلسلة المحارف المعطاة. يمرر إلى هذه الدالة محرفٌ ...

الدالة xor()‎ في Kotlin

تجري الدالة xor()‎ العملية xor المنطقية بين قيمتين منطقيتين. البنية العامة infix fun xor(other: Boolean): Boolean وجود الكلمة المفتاحية infix يدل على أنَّ هذه الدالة يمكن استدعاؤها بنمط التدوين الداخليّ (infix notation)؛ أي من خلال حذف المعامل . والأقواس () المُستخدَمَين في الاستدعاء عادةً. المعاملات other القيمة المنطقية الأخرى التي ستطبق عليها العملية. القيمة المعادة تعاد قيمة منطقية تكون ناتج إجراء العملية xor على القيمتين المعطيتين. أمثلة استخدام الدالة ()xor لتطبيق العملية xor على قيمتين منطقيتين: fun main(args: Array<String>) { println(true xor false) // ...

الدالة replaceIndent()‎ في Kotlin

تبدِّل الدالة replaceIndent()‎ سلسلة نصية جديدة مكان المسافة البادئة الفارغة (indent) في السلسلة النصية التي استُدعيت معها. البنية العامة fun String.replaceIndent(newIndent: String = ""): String المعاملات newIndent السلسلة النصية التي يراد أن تحل مكان المسافة الفارغة البادئة. القيمة الافتراضية هي: "". القيم المعادة تعاد سلسلة نصية تحوي جميع محارف السلسلة النصية المعطاة بعد تبديل قيمة المعامل newIndent مكان المسافة البادئة الفارغة فيها. أمثلة مثالٌ على استعمال الدالة ()replaceIndent: fun main(args: Array<String>) { val str = " ...

الدالة CharSequence.mapIndexed()‎ في Kotlin

تعيد الدالة mapIndexed()‎ قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف السلسلة التي استُدعيت معها. البنية العامة inline fun <R> CharSequence.mapIndexed( transform: (index: Int, Char) -> R ): List<R> وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة (inline functions)). المعاملات transform دالةٌ تطبق على كل محرف من محارف السلسلة المعطاة. يمرر إليها فهرس المحرف وقيمته وتعيد القيمة المقابلة لهذا المحرف. القيم المعادة تُعاد قائمةٌ تضم ناتج تطبيق الدالة transform‎ المُمرّرة على فهرس وقيمة كل ...

الدالة mapIndexedNotNull()‎ في Kotlin

تعيد الدالة mapIndexedNotNull()‎ قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء القيم العدميَّة null التي تعيدها تلك الدالة. البنية العامة يمكن استدعاء الدالةmapIndexedNotNull()‎ مع المصفوفات والمجموعات: inline fun <T, R : Any> Array<out T>.mapIndexedNotNull( transform: (index: Int, T) -> R? ): List<R> inline fun <T, R : Any> Iterable<T>.mapIndexedNotNull( transform: (index: Int, T) -> R? ): List<R> وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة ...

الدالة Char.inc()‎ في Kotlin

تعيد الدالة inc()‎ المحرف اللاحق للمحرف الذي استُدعيت معه. البنية العامة operator fun inc(): Char وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). القيمة المعادة يعاد المحرف اللاحق للمحرف المعطى. أمثلة استعمال الدالة ()dec لجلب الحرف الذي يلي الحرف 'W': fun main(args: Array<String>) { val x = 'W' println(x.inc()) // X } انظر أيضًا الدالة compareTo()‎: توازن بين قيمة العنصر الذي استُدعيت معه والقيمة ...

الدالة filterNotTo()‎ في Kotlin

تشبه الدالة filterNotTo()‎ الدالة filterNot()‎ في جميع النواحي باستثناء أنَّها تضيف الناتج المعاد إلى المعامل الممرَّر إليها. الجدير بالذكر أنّه ينبغي أن يكون ذلك المعامل المعطى مجموعةً قابلةً للتغيير (MutableCollection) إن استدعيت الدالة مع مصفوفة أو مجموعة، أو خريطةً قابلة للتغيير (MutableMap) إن استدعيت الدالة مع خريطة. البنية العامة يمكن استدعاء الدالة filterNotTo()‎ مع المصفوفات أو المجموعات: inline fun <T, C : MutableCollection<in T>> Array<out T>.filterNotTo( destination: C, predicate: (T) -> Boolean ): C inline ...

الدالة withIndex()‎ في Kotlin

تعيد الدالة withIndex()‎ مجموعة تكرارية خاملة (lazy Iterable) من القيم المُفهرسة لكل عنصر من عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها، أو تعيد مُكرّرًا (iterator) يغلّف كل عنصر أنتجه المكرّر (Iterator) المستدعى مع الدالة مع القيمة المُفهرسة أي يعيد القيمة مع فهرسها. البنية العامة يمكن استدعاء الدالة withIndex()‎ مع المصفوفات أو المجموعات التكرارية أو المكرِّرات: fun <T> Array<out T>.withIndex(): Iterable<IndexedValue<T>> fun ByteArray.withIndex(): Iterable<IndexedValue<Byte>> fun ShortArray.withIndex(): Iterable<IndexedValue<Short>> fun IntArray.withIndex(): Iterable<IndexedValue<Int>> fun LongArray.withIndex(): Iterable<IndexedValue<Long>> fun FloatArray.withIndex(): Iterable<IndexedValue<Float>> fun DoubleArray.withIndex(): Iterable<IndexedValue<Double>> fun BooleanArray.withIndex(): Iterable<IndexedValue<Boolean>> fun ...

الدالة Float.compareTo()‎ في Kotlin

توازن الدالة compareTo()‎ بين عدد عشري (float) وعدد آخر ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كان العدد الأول (العدد الذي استُدعي مع الدالة) أصغر من العدد الثاني الممرر إليها، أو قيمة موجبة إن كان العدد الأول أكبر من العدد الثاني. البنية العامة operator fun compareTo(other: Byte): Int operator fun compareTo(other: Short): Int operator fun compareTo(other: Int): Int operator fun compareTo(other: Long): Int operator fun compareTo(other: Float): Int حلت الدالة Comparable.compareTo()‎ مكان الأشكال السابقة من هذه الدالة. operator ...

الدالة Double.unaryPlus()‎ في Kotlin

تعيد الدالة unaryPlus()‎ العدد العشري المضاعف (double) الذي استُدعي معها. البنية العامة operator fun unaryPlus(): Double وجود الكلمة المفتاحيّة operator يدل على أنّ هذه الدالة مرتبطٌة بمعامل تكرار (iteration operator). القيمة المعادة يعاد العدد نفسه المعطى. أمثلة استعمال الدالة ()unaryPlus لإعادة القيمة المستدعاة معها: fun main(args: Array<String>) { val x: Double = 52.54 println(x.unaryPlus()) // 52.54 } انظر أيضًا الدالة unaryMinus()‎: تعيد القيمة السالبة المقابلة للعدد العشري المضاعف (double) الذي استُدعي معها. الدالة inc()‎ : تزيد العدد العشري المضاعف (double) ...

الدالة isHighSurrogate()‎ في Kotlin

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

الدالة CharArray.iterator()‎ في Kotlin

تنشئ الدالة iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. البنية العامة operator fun iterator(): CharIterator وجود الكلمة المفتاحية operator يدل على أنّ هذه الدالة مرتبطٌة بمعامل تكرار (iteration operator، اطلع على المثال في الأسفل). القيم المعادة يعاد عنصرٌ تكراريٌٌ (iterator) من أجل تكرار بنيةٍ (block) برمجيةٍ معينة على كافّة عناصر المصفوفة المعطاة. أمثلة استعمال الدالة iterator()‎ لتخصيص عنصر تكراري من أجل استخدامه في الحلقة for التكرارية التي تطبع قيم جميع العناصر: fun main(args: Array<String>) { val f: (Int) -> ...

الدالة Float.unaryPlus()‎ في Kotlin

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

الدالة reversed()‎ في Kotlin

تُعيد الدالة reversed()‎ قائمة تضم عناصر المصفوفة أو المجموعة التي استُدعيت معها بترتيب معكوس. البنية العامة fun <T> Array<out T>.reversed(): List<T> fun ByteArray.reversed(): List<Byte> fun ShortArray.reversed(): List<Short> fun IntArray.reversed(): List<Int> fun LongArray.reversed(): List<Long> fun FloatArray.reversed(): List<Float> fun DoubleArray.reversed(): List<Double> fun BooleanArray.reversed(): List<Boolean> fun CharArray.reversed(): List<Char> fun <T> Iterable<T>.reversed(): List<T> القيم المعادة تعاد قائمة تضم عناصر المصفوفة أو المجموعة المعطاة بترتيب معكوس. أمثلة استعمال الدالة ()reversed لعكس ترتيب عناصر قائمة: fun main(args: Array<String>) { var list = listOf(1, 2, 3, ...

الدالة Float.toChar()‎ في Kotlin

تحول الدالة toChar()‎ العدد العشري (float) الذي استُدعي معها إلى المحرف الذي يقابله (أي من النوع Char) بعد اقتطاعه إلى 16 بت إن تطلب ذلك. البنية العامة fun toChar(): Char حلت الدالة Number.toChar()‎ مكان هذه الدالة. القيمة المعادة يعاد المحرف الذي تساوي قيمته العددية العدد العشري المعطى. أمثلة استعمال الدالة ()toChar لتحويل عدة أعداد عشرية إلى ما يقابلها من محارف: fun main(args: Array<String>) { val x: Float = 97.4f val y: Float = 50.2f ...

الدالة CharSequence.maxWith()‎ في Kotlin

تجلب الدالة maxWith()‎ المحرف الأول من سلسلة المحارف التي استُدعيت معها والذي له أكبر قيمة بحسب الموازن comparator المعطى. البنية العامة fun CharSequence.maxWith( comparator: Comparator<in Char> ): Char? وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات comparator دالةٌ تمثل الموزان الذي سيُطبَّق على كل محرف من محارف السلسلة المعطاة. القيم المعادة يُعاد المحرف الأول من سلسلة المحارف المعطاة والذي له أكبر قيمة بحسب الدالة comparator الموازنة المعطاة، أو القيمة null إن لم يكن هنالك أي عنصر. أمثلة مثال عن استعمال الدالة ...

الدالة isEmpty()‎ في Kotlin

تتحقق الدالة isEmpty()‎ إن كانت سلسلة المحارف التي استٌدعيت معها فارغةً. البنية العامة inline fun CharSequence.isEmpty(): Boolean وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كانت سلسلة المحارف التي استٌدعيت معها فارغةً، أو القيمة false خلاف ذلك. أمثلة مثالٌ على استعمال الدالة isEmpty()‎: fun main(args: Array<String>) { print("hsoub".isEmpty()) // false print(" ".isEmpty()) // false ...

الخاصية CharArray.size في Kotlin

تمثِّل الخاصيّة CharArray.size عدد العناصر الموجودة في المصفوفة ذات النوع CharArray. البنية العامة val size: Int القيم المعادة يعاد عددٌ صحيحٌ يمثِّل عدد العناصر في المصفوفة المعطاة. أمثلة استعمال الخاصيّة size لمعرفة عدد العناصر الموجود في مصفوفة من النوع CharArray: fun main(args: Array<String>) { val array = CharArray(6) print(array.size) // 6 } انظر أيضًا الصنف ‎CharArray. الدالة CharArray()‎: تنشئ مصفوفة جديدة من النوع CharArray (أي مصفوفة من الحروف) بحجم معين، وتحوي قيمًا محدَّدة أو القيمة '‎\u0000' التي تمثل حرفًا عدميًّا.   التابع ()get: يجلب عنصرًا ذي فهرس محدد من ...

الدالة CharSequence.hasSurrogatePairAt()‎ في Kotlin

تتحقق الدالة hasSurrogatePairAt()‎ إن كان لدى سلسلة المحارف التي استُدعيت معها زوجًا بديلًا في الترميز الموحد (Unicode surrogate pair) للمحرف ذي الفهرس المُحدّد. البنية العامة fun CharSequence.hasSurrogatePairAt(index: Int): Boolean المعاملات index عدد صحيح يمثل فهرس المحرف الذي سيُتحقَق منه. القيم المعادة تعاد القيمة true إن كان لدى سلسلة المحارف التي استُدعيت معها زوجًا بديلًا في الترميز الموحد (Unicode surrogate pair) عند الفهرس index، أو تعاد القيمة false خلاف ذلك. أمثلة مثالٌ على استعمال الدالة ()hasSurrogatePairAt: fun main(args: Array<String>) { ...

الدالة CharSequence.subSequence()‎ في Kotlin

تجلب الدالة subSequence()‎‎ جزءًا محددًا يقع في سلسلة الحروف التي استٌدعيت معها. البنية العامة abstract fun subSequence( startIndex: Int, endIndex: Int ): CharSequence المعاملات startIndex عدد صحيح يشير إلى فهرس المحرف الذي يمثل بداية الجزء المراد جلبه. endIndex عدد صحيح يشير إلى فهرس المحرف الذي يمثل نهاية الجزء المراد جلبه (لا يدخل هذا المحرف ضمن المجال). القيمة المعادة يعاد الجزء الواقع بين الحرف ذي الفهرس startIndex والحرف ذي الفهرس endIndex في سلسلة المحارف المعطاة. ...

الدالة Byte.rem()‎ في Kotlin

تحسب الدالة rem()‎ باقي عملية قسمة العدد الذي استُدعيت معه على العدد الممرّر إليها. البنية العامة operator fun rem(other: Byte): Int operator fun rem(other: Short): Int operator fun rem(other: Int): Int operator fun rem(other: Long): Long operator fun rem(other: Float): Float operator fun rem(other: Double): Double وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other العدد الآخر المراد تطبيق العملية عليه. القيمة المعادة يعاد باقي عملية قسمة العدد الذي استُدعي مع الدالة على العدد الممرّر ...

الدالة toShort()‎ في Kotlin

تحلّل الدالة toShort()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد قصير. البنية العامة inline actual fun String.toShort(): Short تحلّل الدالة toShort()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد قصير. في حال لم تكن السلسلة النصية تمثل عددًا، فسيُطلَق الاستثناء NumberFormatException. inline actual fun String.toShort(radix: Int): Short الإصدار المطلوب:Kotlin 1.1. تحلّل الدالة toShort()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد قصير. في حال لم تكن السلسلة النصية تمثل عددًا، فسيُطلَق الاستثناء NumberFormatException. أما في حال كان المعامل radix المعطى أساسًا غير صالح لتحويل السلسلة ...

الدالة Byte.plus()‎ في Kotlin

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

الدالة slice()‎ في Kotlin

تقتطع الدالة slice()‎ جزءًا محدَّدًا من سلسلة المحارف أو السلسلة النصية  التي استُدعيت معها ثمَّ تعيده. البنية العامة fun CharSequence.slice(indices: IntRange): CharSequence fun String.slice(indices: IntRange): String fun CharSequence.slice(indices: Iterable<Int>): CharSequence inline fun String.slice(indices: Iterable<Int>): String وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات indices مجال من النوع IntRange أو كائن من النوع Iterable يحدد الجزء المراد اقتطاعه من سلسلة المحارف أو السلسلة النصية المعطاة. القيم المعادة تعاد سلسلة من المحارف أو سلسلة نصية تحوي الجزء المقتطع من سلسلة المحارف ...

الدالة toLongOrNull()‎ في Kotlin

تحلّل الدالة toLongOrNull()‎ السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد طويل. البنية العامة fun String.toLongOrNull(): Long? الإصدار المطلوب:Kotlin 1.1. تحلّل الدالة toLongOrNull()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد طويل. في حال لم تكن السلسلة النصية تمثل عددًا فستعيد القيمة null. fun String.toLongOrNull(radix: Int): Long? الإصدار المطلوب:Kotlin 1.1. تحلّل الدالة toLongOrNull()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد طويل. في حال لم تكن السلسلة النصية تمثل عددًا، فستعيد الدالة القيمة null. أما في حال كان المعامل radix المعطى أساسًا غير صالح لتحويل السلسلة ...

الصنف ‎‎ByteArray‎ في Kotlin

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

الدالة toList()‎ في Kotlin

تحول الدالة toList()‎ المصفوفة أو المجموعة التكرارية أو الخريطة التي استُدعيت معها إلى قائمة. البنية العامة يمكن استدعاء الدالة toList()‎ مع المصفوفات أو المجموعات التكرارية أو الخرائط: fun <T> Array<out T>.toList(): List<T> fun ByteArray.toList(): List<Byte> fun ShortArray.toList(): List<Short> fun IntArray.toList(): List<Int> fun LongArray.toList(): List<Long> fun FloatArray.toList(): List<Float> fun DoubleArray.toList(): List<Double> fun BooleanArray.toList(): List<Boolean> fun CharArray.toList(): List<Char> fun <T> Iterable<T>.toList(): List<T> fun <K, V> Map<out K, V>.toList(): List<Pair<K, V>> القيمة المعادة تعاد قائمة تحوي جميع عناصر المصفوفة أو المجموعة التكرارية أو جميع أزواج ...

الدالة removeSurrounding()‎ في Kotlin

تحذف الدالة removeSurrounding()‎ بادئة ولاحقة محددتين من سلسلة من المحارف أو سلسلة نصية.  البنية العامة fun CharSequence.removeSurrounding( prefix: CharSequence, suffix: CharSequence ): CharSequence fun String.removeSurrounding( prefix: CharSequence, suffix: CharSequence ): String fun CharSequence.removeSurrounding( delimiter: CharSequence ): CharSequence fun String.removeSurrounding(delimiter: CharSequence): String المعاملات prefix سلسلة من المحارف تمثل البادئة المراد حذفها. suffix سلسلة من المحارف تمثل اللاحقة المراد حذفها. delimiter سلسلة من المحارف تمثل البادئة واللاحقة المراد حذفها. عند استعمال ...

الدالة toLowerCase()‎ في Kotlin

تحوّل الدالة toLowerCase()‎ المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف صغيرة (lowercase). البنية العامة inline actual fun Char.toLowerCase(): Char inline actual fun String.toLowerCase(): String inline fun String.toLowerCase(locale: Locale): String المنصة المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). المعاملات locale المحلية المراد ضبطها إلى منطقة جغرافية محددة وأخذها بالحسبان أثناء عملية التحويل. القيم المعادة يعاد المحرف المعطى بعد تحويله إلى محرف صغير، أو تعاد السلسلة النصية المعطاة ...

الدالة drop()‎ في Kotlin

تعيد الدالة drop()‎ قائمة تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء أول n عنصر. البنية العامة fun <T> Array<out T>.drop(n: Int): List<T> fun ByteArray.drop(n: Int): List<Byte> fun ShortArray.drop(n: Int): List<Short> fun IntArray.drop(n: Int): List<Int> fun LongArray.drop(n: Int): List<Long> fun FloatArray.drop(n: Int): List<Float> fun DoubleArray.drop(n: Int): List<Double> fun BooleanArray.drop(n: Int): List<Boolean> fun CharArray.drop(n: Int): List<Char> fun <T> Iterable<T>.drop(n: Int): List<T> المعاملات n عدد صحيح يمثل عدد العناصر المراد حذفها من بداية المصفوفة أو المجموعة المعطاة. القيم المعادة تُعاد قائمة ...

الدالة substringBefore()‎ في Kotlin

تجلب الدالة substringBefore()‎ كل الجزء الواقع قبل أول ظهور لمحرف أو لسلسلة نصية معينة في سلسلة نصية. البنية العامة fun String.substringBefore( delimiter: Char, missingDelimiterValue: String = this ): String fun String.substringBefore( delimiter: String, missingDelimiterValue: String = this ): String المعاملات delimiter المحرف أو السلسلة النصية التي يراد جلب كامل الجزء الواقع قبلها. missingDelimiterValue السلسلة النصية التي ستعاد في حال لم يكن المعامل delimiter موجودًا ضمن السلسلة النصية المعطاة. القيمة الافتراضية هي: this (أي السلسلة النصية المعطاة نفسها). القيم المعادة ...

الثابت Float.NEGATIVE_INFINITY في Kotlin

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

الدالة Double.inc()‎ في Kotlin

تزيد الدالة inc()‎ العدد العشري المضاعف (double) الذي استُدعي معها بمقدار 1 ثمَّ تعيد القيمة الناتجة. البنية العامة operator fun inc(): Double وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). القيمة المعادة تعاد قيمة من النوع Double تمثل القيمة المعطاة بعد زيادتها بمقدار 1. أمثلة استعمال الدالة ()dec لزيادة عدد عشري مضاعف بمقدار 1 فقط: fun main(args: Array<String>) { val x: Double = 5.67 println(x.inc()) // 6.67 } ...

الدالة toCollection()‎ في Kotlin

تضيف الدالة toCollection()‎ كل محارف السلسلة التي استٌدعيت معها إلى المجموعة المتغيرة المُمرّرة إليها. البنية العامة fun <C : MutableCollection<in Char>> CharSequence.toCollection( destination: C ): C المعاملات مجموعة متغيرة يراد أن يضاف فيها محتوى سلسلة المحارف المعطاة. القيم المعادة يعاد المعامل destination بعد إضافة محتوى سلسلة المحارف المعطاة إليه. أمثلة مثالٌ على استعمال الدالة toCollection()‎: fun main(args: Array<String>) { val list: MutableList<Char> = mutableListOf() val str = "wikiHsoub" str.toCollection(list) ...

الدالة isArrayOf()‎ في Kotlin

تتحقَّق الدالة isArrayOf()‎ من حواية المصفوفة التي استُدعيت معها عناصرَ من نوعٍ محدَّد. البنية العامة fun <reified T : Any> Array<*>.isArrayOf(): Boolean يدل استخدام الكلمة المفتاحية reified على إمكانية الوصول إلى نوعٍ مُمرَّر كمتحولٍ وسيطٍ (راجع توثيق reified للمزيد من التفاصيل). القيم المعادة تُعاد القيمة المنطقية true إن كانت المصفوفة المعطاة تحوي النوع المعطى أو القيمة false خلاف ذلك. أمثلة مثالٌ على استعمال الدالة  ()isArrayOf: fun main(args: Array<String>) { var numbers = Array(6) { i -> i } println(numbers.isArrayOf<Int>()) // ...

الدالة Double.toChar()‎ في Kotlin

تحول الدالة toChar()‎ العدد العشري المضاعف (double) الذي استُدعي معها إلى المحرف الذي يقابله (أي من النوع Char) بعد اقتطاعه إلى 16 بت إن تطلب ذلك. البنية العامة fun toChar(): Char حلت الدالة Number.toChar()‎ مكان هذه الدالة. القيمة المعادة يعاد المحرف الذي تساوي قيمته العددية العدد العشري المضاعف المعطى. أمثلة استعمال الدالة ()toChar لتحويل عدة أعداد عشرية مضاعفة إلى ما يقابلها من محارف: fun main(args: Array<String>) { val x: Double = 97.4 val y: ...

الدالة count()‎ في Kotlin

تعيد الدالة count()‎ عدد جميع عناصر المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها أو العناصر التي تحقق شرطًا معينًا. البنية العامة إن استدعيت الدالة count()‎ مع مصفوفة دون تمرير أي معامل، فستعيد عدد عناصر هذه المصفوفة. inline fun <T> Array<out T>.count(): Int inline fun ByteArray.count(): Int inline fun ShortArray.count(): Int inline fun IntArray.count(): Int inline fun LongArray.count(): Int inline fun FloatArray.count(): Int inline fun DoubleArray.count(): Int inline fun BooleanArray.count(): Int inline fun CharArray.count(): Int وإن استدعيت مع تمرير الدالة predicate المنطقيَّة ...

الدالة toCharArray()‎ في Kotlin

تضع الدالة toCharArray()‎ جميع محارف السلسلة النصية التي استٌدعيت معها في مصفوفة من النوع CharArray، إذ يوضع كل محرف في عنصر. البنية العامة inline fun String.toCharArray(): CharArray بيئة التشغيل المطلوبة: JVM. تعيد الدالة toCharArray()‎ مصفوفة من النوع CharArray تحتوي حروف السلسلة النصية التي استٌدعيت عبرها. inline fun String.toCharArray( destination: CharArray, destinationOffset: Int = 0, startIndex: Int = 0, endIndex: Int = length ): CharArray بيئة التشغيل المطلوبة: JVM. ...

الدالة findLast()‎ في Kotlin

تبحث الدالة findLast()‎ على محرف يحقق شرطًا محدَّدًا ضمن محارف السلسلة التي استُدعيت معها ثمَّ تعيد آخر ظهور له. البنية العامة inline fun CharSequence.findLast( predicate: (Char) -> Boolean ): Char? وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات predicate دالةٌ تمثل الشرط المراد تطبيقه على كل محرف من محارف السلسلة المعطاة. يمرر إلى هذه الدالة قيمة المحرف وتعيد قيمةً منطقيةً. القيم المعادة يعاد آخر ظهور للمحرف المبحوث عنه ضمن محارف السلسلة المعطاة والذي يحقق الشرط ...

الدالة Enum.toString()‎ في Kotlin

تحول الدالة toString()‎ الكائن الذي استُدعي معها إلى سلسلة نصية (String). البنية العامة open fun toString(): String القيمة المعادة تعاد سلسلة نصية تضم جميع محتويات الكائن المعطى. أمثلة استعمال الدالة toString()‎ لتحويل أحد ثوابت نسخة أنشئت من الصنف Enum إلى سلسلة نصية: fun main(args: Array<String>) { val x = ColorEnum.Red print(x.toString()) // Red } enum class ColorEnum(val colorCode: Int) { Red(2), Blue(11212), Green(21212), Orange(212121) } انظر ...

الدالة max()‎ في Kotlin

تجلب الدالة max()‎ أكبر عنصر في المصفوفة أو المجموعة التي استُدعيت معها. البنية العامة fun Array<out Double>.max(): Double? fun Array<out Float>.max(): Float? fun FloatArray.max(): Float? fun DoubleArray.max(): Double? fun Iterable<Double>.max(): Double? fun Iterable<Float>.max(): Float? fun <T : Comparable<T>> Array<out T>.max(): T? fun ByteArray.max(): Byte? fun ShortArray.max(): Short? fun IntArray.max(): Int? fun LongArray.max(): Long? fun CharArray.max(): Char? fun <T : Comparable<T>> Iterable<T>.max(): T? الإصدار المطلوب: Kotlin 1.1. القيم المعادة يُعاد أكبر عنصر في المصفوفة أو المجموعة المعطاة، أو القيمة null إن كانت تلك المصفوفة أو ...

الدالة CharSequence.forEach()‎ في Kotlin

تُنفّد الدالةُ forEach()‎ الدالةَ المُمرّرةَ إليها على كل محرف من محارف السلسلة التي استُدعيت معها. البنية العامة inline fun CharSequence.forEach( action: (Char) -> Unit) وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات action الدالة المراد تنفيذها مع كل محرف من محارف السلسلة المعطاة. أمثلة مثالٌ على استعمال الدالة ()forEach: fun main(args: Array<String>) { val str = "Hsoub wiki" str.forEach {print("$it:")} // H:s:o:u:b: :w:i:k:i: } انظر أيضًا الدالة forEachIndexed()‎: ...

الصنف ‎‎Char‎ في Kotlin

يمثل الصنف Char محرفًا بحجم 16 بت مرمزًا بالترميز الموحَّد (Unicode). في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثَّل كقيم للنوع char الأساسي. class Char : Comparable<Char> الدوال compareTo توازن الدالة compareTo()‎ بين قيمة المحرف الذي استُدعي معها والقيمة المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة المحرف الذي استُدعي معها) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية. dec تعيد الدالة dec()‎ المحرف السابق للمحرف الذي ...

الدالة Float.toLong()‎ في Kotlin

تحوّل الدالة toLong()‎ العدد العشري (float) الذي استُدعي معها إلى عدد من النوع Long (عدد طويل). هذا قد يؤدي إلى تدوير العدد المراد تحويله أو اقتطاع جزءٍ منه. البنية العامة fun toLong(): Long حلت الدالة Number.toLong()‎ مكان هذه الدالة. القيمة المعادة يعاد عدد من النوع Long يحوي العدد العشري المراد تحويله. أمثلة استعمال الدالة ()toLong لتحويل عدد من النوع Float إلى النوع Long: fun main(args: Array<String>) { val x : Float = 52.5f println(x.toLong() )// 52 } انظر أيضًا الدالة toByte()‎: تحول ...

الدالة append()‎ في Kotlin

تضيف الدالة append()‎ سلسلة المحارف الممررة إليها إلى الكائن الذي استُدعي معها. البنية العامة fun <T> T.append(vararg value: CharSequence?): T المعاملات value سلسلة المحارف التي يراد إضافتها إلى الكائن المعطى. القيم المعادة يعاد الكائن نفسه المعطى بعد إضافة سلسلة المحارف value إليه. أمثلة استعمال الدالة append()‎ لإضافة سلسلة من المحارف إلى كائن من النوع StringBuilder: fun main(args: Array<String>) { val str = StringBuilder("hsoub") println(str.append(" academy")) // hsoub academy } انظر أيضًا الدالة append()‎: تضيف المحرف الممرر إليها أو كامل محتوى الكائن المُمرّر إليها أو ...

الخاصية ‎‎lastIndex في Kotlin

تُستخدَم هذه الخاصيّة للحصول على الفهرس (index) الأخير للمصفوفة أو القائمة (list)، أو القيمة ‎-1 إن كانت المصفوفة أو القائمة فارغةً. البنية العامة توفّر لغة Kotlin الخاصيّة lastIndex للمصفوفات من الأنواع المختلفة كما يلي: val <T> Array<out T>.lastIndex: IntRange val ByteArray.lastIndex: IntRange val ShortArray.lastIndex: IntRange val IntArray.lastIndex: IntRange val LongArray.lastIndex: IntRange val FloatArray.lastIndex: IntRange val DoubleArray.lastIndex: IntRange val BooleanArray.lastIndex: IntRange val CharArray.lastIndex: IntRange وكذلك للقائمة (list): val <T> List<T>.lastIndex: Int القيم المعادة يعاد الفهرس الأخير للمصفوفة أو القائمة، أو القيمة ‎-1 إن كانت المصفوفة أو القائمة فارغة. أمثلة استخدام ...

الدالة sliceArray()‎ في Kotlin

تقطع الدالة sliceArray()‎ جزءًا محدَّدًا من المصفوفة التي استُدعيت معها ثمَّ تعيده في مصفوفة أو قائمة بحسب الوسيط الممرر إليها.  البنية العامة إن مرِّر كائن من النوع Collection إلى الدالة sliceArray()‎، فستُعاد مصفوفة تحوي عناصر المصفوفة التي استُدعيت معها والموجودة في الموقع الذي يحدده الوسيط indices: fun <T> Array<T>.sliceArray( indices: Collection<Int> ): Array<T> fun ByteArray.sliceArray(indices: Collection<Int>): ByteArray fun ShortArray.sliceArray( indices: Collection<Int> ): ShortArray fun IntArray.sliceArray(indices: Collection<Int>): IntArray fun LongArray.sliceArray(indices: Collection<Int>): LongArray fun FloatArray.sliceArray( indices: Collection<Int> ): FloatArray ...

الخاصية Enum.ordinal في Kotlin

تمثل الخاصية Enum.ordinal ترتيب (ordinal) الثابت المعرف في الكائن enum الذي استُدعي معها؛ أي موقعه في تصريح الكائن enum، إذ يكون موقع الثابت الأول هو 0 وهكذا. البنية العامة val ordinal: Int أمثلة توضح الشيفرة التالية كيفية إنشاء صنف من النوع Enum باسم ColorEnum مكونًا من أربعة ثوابت هي: Red و Blue و Green و Orange، واستعمال الخاصية ordinal مع المركّبتين Red و Blue لمعرفة ترتيبهما: fun main(args: Array<String>) { print(ColorEnum.Red.ordinal) // 0 print(ColorEnum.Blue.ordinal) // 1 } enum class ColorEnum(val colorCode: Int) { ...

الدالة contentDeepHashCode()‎ في Kotlin

تشِّفر الدالة contentDeepHashCode()‎ محتوى المصفوفة التي استُدعيت معها كما لو كانت قائمة إلى شيفرة Hash. تعامل المصفوفات المُتشعبة مثل القوائم أيضًا. إن حَوَت المصفوفة نفسها في أي مستوى من المستويات المتشعبة، فسيكون سلوك الدالة غير محدَّد. البنية العامة inline fun <T> Array<out T>.contentDeepHashCode(): Int الإصدار المطلوب: Kotlin 1.1 وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة). القيم المعادة  شيفرة Hash لمحتوى المصفوفة المعطاة كما لو كانت قائمة. أمثلة استخدام الدالة ()contentDeepHashCode مع المصفوفات المتشعبة ...

الدالة requireNoNulls()‎ في Kotlin

تعيد الدالة requireNoNulls()‎ العناصر غير المعدومة (non-null) من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها أو ترمي استثناءً إن وجد عنصر معدوم (null). البنية العامة fun <T : Any> Array<T?>.requireNoNulls(): Array<T> fun <T : Any> Iterable<T?>.requireNoNulls(): Iterable<T> fun <T : Any> List<T?>.requireNoNulls(): List<T> القيم المعادة تعاد المصفوفة أو المجموعة أو القائمة المعطاة نفسها إن لم يكن فيها أي عنصر معدوم أو يرمى الاستثناء IllegalArgumentException إن وجد أي عنصر معدوم. أمثلة استعمال الدالة ()requireNoNulls مع قائمة لا تحتوي على أي عنصر معدوم: fun ...

الثابت Float.MIN_VALUE في Kotlin

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

الدالة windowedSequence()‎ في Kotlin

تعيد الدالة windowedSequence()‎ سلسلة تحتوي على سلاسل نصية بحجم معين ثابت جلبت من سلسلة المحارف التي استدعيت معها عند التحرك بخطوات محددة ثابتة، أو تحوي ناتج تطبيق دالة معينة على تلك السلاسل النصية المجلوبة.   البنية العامة fun CharSequence.windowedSequence( size: Int, step: Int = 1, partialWindows: Boolean = false ): Sequence<String> الإصدار المطلوب: Kotlin 1.2. تعيد الدالة windowedSequence()‎ سلسلة مكونة من سلاسل نصية حجم كل منها يساوي size جلبت من سلسلة المحارف ...

الدالة Byte.toInt()‎ في Kotlin

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

الصنف ‎‎Byte‎ في Kotlin

يمثل الصنف Byte عددًا صحيحًا ذا إشارة (signed integer) بحجم 8 بت. في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثَّل كقيم للنوع byte الأساسي. class Byte : Number, Comparable<Byte> الدوال compareTo توازن الدالة compareTo()‎ بين قيمة العنصر الذي استُدعي معها والقيمة المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية. dec تنقص الدالة dec()‎ القيمة ...

الدالة Double.minus()‎ في Kotlin

تطرح الدالة minus()‎ العدد الممرّر إليها من العدد العشري المضاعف (double) الذي استُدعي معها ثم تعيد الناتج. البنية العامة operator fun minus(other: Byte): Double operator fun minus(other: Short): Double operator fun minus(other: Int): Double operator fun minus(other: Long): Double operator fun minus(other: Float): Double operator fun minus(other: Double): Double وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other العدد الآخر الذي ستُجرَى عليه العملية. القيمة المعادة يعاد عدد عشري مضاعف يحوي ناتج طرح العدد other الممرّر من العدد العشري المضاعف ...

الدالة toSortedSet()‎ في Kotlin

تضيف الدالة toSortedSet()‎ كل محارف السلسلة  التي استٌدعيت معها إلى مجموعة من النوع SortedSet، إذ يوضع كل محرف في عنصر. البنية العامة fun CharSequence.toSortedSet(): SortedSet<Char> منصة التشغيل المطلوبة: JVM. القيم المعادة تعاد مجموعة جديدة من النوع SortedSet تحوي جميع محتويات أمثلة مثالٌ على استعمال الدالة toSortedSet()‎: fun main(args: Array<String>) { println("Hello, world!".toSortedSet()) // [ , !, ,, H, d, e, l, o, r, w] println("Hsoub".toSortedSet()) // [H, b, o, s, u] println("114".toSortedSet()) ...

عرض (500 السابقة | 500 التالية) (20 | 50 | 100 | 250 | 500).