نتائج البحث

تحوّل الدالة 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 القيمة القصوى للبديل الأعلى لعدد بتات الترميز الموحد (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()‎ بطريقتين: استدعاء بنية (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) الدالة المُحدَّدة ...

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

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

تحشو الدالة padStart()‎ بداية سلسلة نصية أو سلسلة من المحارف بمحرف محدد. البنية العامة fun CharSequence.padStart( length: Int, padChar: Char = ' ' ): CharSequence fun String.padStart(length: Int, padChar: Char = ' '): String وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات length طول البادئة المراد ملؤها بالمحرف padChar. padChar المحرف المراد إضافته إلى بداية سلسلة من المحارف أو سلسلة نصية. القيمة الافتراضية له هي: ' ' ...

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

أصبحت الخاصية CharSequence.size مهملة، لذا استخدم الخاصية CharSequence.length بدلًا منها. انظر أيضًا الخاصية CharSequence.length: تمثل الخاصية CharSequence.length عدد عناصر سلسلة الحروف المستدعاة معها. مصادر صفحة الخاصية size في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

يمثل الصنف Regex تعبيرًا نمطيا قابلًا للتعديل (immutable regular expression). إن أردت الاطلاع على المزيد من المعلومات المتعلقة بصياغة النمط (pattern)، انتقل إلى صفحة الصنف Pattern. actual class Regex : Serializable الدوال البانية <init> تنشئ الدالة Regex()‎ تعبيرًا نمطيًا (regular expression) انطلاقًا من السلسلة النصية المُمرّرة إليه. الخاصيات options تمثل هذه الخاصية مجموعةَ الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعي معها. pattern تمثل هذه الخاصية النمط الأولي الذي استُخدم في إنشاء التعبير النمطي الذي استُدعي معها. الدوال containsMatchIn ...

تنشئ الدالة buildString()‎ سلسلة نصية جديدة عبر ملئها بالكائن StringBuilder المُنشأ حديثًا ثم تحويله إلى سلسلة نصية. البنية العامة inline fun buildString( builderAction: StringBuilder.() -> Unit ): String (source) inline fun buildString( capacity: Int, builderAction: StringBuilder.() -> Unit ): String الإصدار المطلوب: Kotlin 1.1. وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions)). المعاملات builderAction capacity عددٌ صحيحٌ. إن إن أعطي هذا المعامل capacity، فإنّ الكائن ...

تطبّق الدالة onEach()‎ دالةً محددةً على كل محرف من محارف السلسلة التي استٌدعيت معها، ثم تعيد تلك السلسلة. البنية العامة inline fun <S : CharSequence> S.onEach( action: (Char) -> Unit ): S بيئة التشغيل المطلوبة: Kotlin 1.1. وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات action الدالة المراد تطبيقها على كل محرف من محارف السلسلة المعطاة. يمرر إلى الدالة كل محرف على حدة ثم تعيد قيمة مقابلة له. القيم المعادة ...

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

تحول الدالة String()‎ جميع محتويات المصفوفة أو الكائن الممرر إليها (أو جزء منها فقط) إلى سلسلة نصية ويمكن أن تكون بترميز محدد. البنية العامة inline fun String(bytes: ByteArray, charset: Charset): String inline fun String( bytes: ByteArray, offset: Int, length: Int, charset: Charset ): String بيئة التشغيل المطلوبة: JVM. تحول الدالة String()‎ جميع محتويات المصفوفة bytes أو جزءًا محددًا منها (يبدأ عند العنصر الذي ينزاح بمقدار offset ...

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

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

تجلب الدالة take()‎ آخر n محرف من سلسلة المحارف أو السلسلة النصية التي استُدعيت معها وتضعها في قائمة.   البنية العامة fun CharSequence.takeLast(n: Int): CharSequence fun String.takeLast(n: Int): String المعاملات n عدد صحيح يمثل عدد المحارف الأخيرة المراد جلبها من سلسلة المحارف المعطاة. إن كانت القيمة المعطاة لهذا المعامل أكبر من طول سلسلة المحارف، فستعاد كل المحارف الموجودة في السلسلة. القيم المعادة تعاد سلسلة من المحارف أو سلسلة نصية تحوي آخر n محرف من سلسلة المحارف أو السلسلة النصية المعطاة.  أمثلة مثالٌ على استعمال الدالة ()takeLast: fun ...

يمثل الثابت 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: يمثل القيمة الدنيا لبديل ...

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

تعيد الدالة Array.iterator()‎ عنصرًا تكراريًّا (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة. البنية العامة operator fun iterator(): Iterator<T> ويُلاحظ وجود الكلمة المفتاحية operator للدلالة على أنّ هذه الدالة مرتبطٌ بمعامل التكرار (iteration operator) المستخدم في شيفرة المثال اللاحق. القيم المعادة يعاد عنصرٌ تكراريٌّ (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة. أمثلة تنشِئ الشيفرة الآتية مصفوفةً من ستة أعدادٍ صحيحةٍ بالاعتماد على الدالة arrayOf ثم تخصِّص لهذه المصفوفة عنصرًا تكراريًا (iterator) باستخدام الدالة iterator()‎ لاستخدامه في ...

تعيد الدالة 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()‎ هي واجهة برمجية (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 في التوثيق الرسميّ للمكتبة القياسيّة في لغة ...

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

تعيد الدالة codePointBefore()‎ المحرف (Unicode code point) الموجود قبل الفهرس المُحدّد. البنية العامة inline fun String.codePointBefore(index: Int): Int منصة التشغيل المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات index عدد صحيح يمثل فهرس العنصر الذي يلي العنصر المستهدف في السلسلة النصية المعطاة. القيم المعادة يعاد عدد صحيح يمثل المحرف الذي يسبق المحرف ذا الفهرس index من السلسلة النصية المعطاة.  أمثلة مثالٌ على استعمال الدالة ()codePointBefore: fun main(args: Array<String>) { ...

تمثل الواجهة Function قيمةً لنوع وظيفي (functional type) -مثل تعبير lambda-، أو دالة مجهولة، أو مرجع دالة. interface Function<out R> إذ يعيد المعامل R نوع الدالة. الدوال الموروثة equals تتحقق الدالة equals()‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معه. وأيُّ تعريف لاستخدام هذه الدالة يجب أن يكون: hashCode تعيد الدالة hashCode()‎ الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. تُحقِّق هذه الدالة الشرطين الآتيين دائمًا: toString تحول الدالة toString()‎ الكائن الذي يُستدعى معه إلى سلسلة نصية (String). الدوال الإضافية (Extension Functions) reflect ...

تمثل الخاصية MatchGroup.value قيمة مجموعة النتائج التي تم الحصول عليها. البنية العامة actual val value: String القيم المعادة تعاد قيمة مجموعة النتائج التي تم الحصول عليها. انظر أيضًا الخاصية MatchGroup.range: تمثل مجال الفهارس التي تحدّد مكان مجموعة النتائج التي تم الحصول عليها. مصادر صفحة الخاصيّة MatchGroup.value في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

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

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

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

تمثِّل الخاصيّة 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()‎: تنشئ عنصرًا ...

تمثل الخاصيّة CharSequence.lastIndex فهرس المحرف الأخير في سلسلة المحارف التي استُدعيت معها. البنية العامة val CharSequence.lastIndex: Int القيم المعادة يعاد عدد صحيح يمثل فهرس العنصر الأخير الموجود ضمن سلسلة المحارف المعطاة، أو تعاد القيمة 1- إن كانت سلسلة المحارف تلك فارغةً. أمثلة استعمال الخاصية CharSequence.lastIndex لمعرفة فهرس العنصر الأخير في سلسلة من المحارف: fun main(args: Array<String>) { val x = "hsoub" print(x.lastIndex) // 4 } انظر أيضًا الدالة ()get: تجلب العنصر ذي ...

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

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

تطابق الدالة match()‎ التعبير النمطي المُمرّر إليها في السلسلة النصية التي استٌدعيت معها. البنية العامة inline fun String.match(regex: String): Array<String>? منصة التشغيل المطلوبة: JS. وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). المعاملات regex التعبير النمطي المراد مطابقته مع السلسلة النصية المعطاة. القيم المعادة مصفوفة تحتوي على السلاسل النصية المُطابقة للتعبير النمطي regex في السلسلة النصية المعطاة. أمثلة مثالٌ على استعمال الدالة match()‎: fun main(args: Array<String>) { val str ...

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

تبدل الدالة replace()‎ محرفًا جديدًا مكان محرف قديم، أو سلسلة نصية جديدة مكان سلسلة نصية قديمة، أو سلسلة نصية جديدة أو ناتج تنفيذ دالة مكان كل ما يطابق تعبير نمطي معين في سلسلة نصية أو سلسلة من المحارف. البنية العامة actual fun String.replace( oldChar: Char, newChar: Char, ignoreCase: Boolean = false ): String actual fun String.replace( oldValue: String, newValue: String, ...

تعيد الدالة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) // ...

تمثل الخاصية length‎ حجم الكائن StringBuilder (عدد محارفه) الذي استدعي معها. البنية العامة actual val length: Int منصة التشغيل المطلوبة: JS. حلت الخاصية CharSequence.length مكان هذه الخاصية. القيمة المعادة يعاد حجم الكائن StringBuilder (عدد محارفه) المعطى. أمثلة استعمال الخاصية length‎ لمعرفة حجم كائن من النوع StringBuilder: fun main(args: Array<String>) { val sb = StringBuilder("hsoub") println(sb.length) // => 5 } انظر أيضًا الدالة append()‎: تضيف محرفًا أو سلسلة نصية أو أيَّ كائن آخر إلى الكائن StringBuilder. الدالة toString()‎: تحول الكائن ...

تتحقق الدالة isWhitespace()‎ إن كان المحرف الذي استٌدعي معها هو مسافة بيضاء (whitespace). البنية العامة actual fun Char.isWhitespace(): Boolean القيم المعادة تعاد القيمة true إن كان المحرف الذي استٌدعي معها هو مسافة بيضاء، أو القيمة false خلاف ذلك. أمثلة استعمال الدالة isWhitespace()‎ لمعرفة أي المحرفين التاليين هو مسافة بيضاء: fun main(args: Array<String>) { val x = '_' val y = ' ' print(x.isWhitespace()) // false ...

الخاصيات الموروثة (Inherited Properties) name تعيد الخاصية name اسم الثابت من الكائن enum الذي استُدعيت عبره، كما سُمّيت أُثناء تعريف ذلك الكائن. ordinal تعيد الخاصية ordinal ترتيب الثابت من الكائن enum الذي استُدعيت عبره  enumeration constant‎)‎‎)، أي ترتيبها في تصريح الكائن enum،بحيث تأخذ المُركّبة الأولى العدد 0. الدوال الموروثة clone يطلق التابع clone()‎ استثناءً (exception) لأنّ ثوابت enum  لا يمكن أن تُنسخ. هذا التابع يمنع الأصناف من النوع Enum من أن ترِث من الصنفCloneable. compareTo تقارن الدالةcompareTo()‎ بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة 0 إن كانا متساويين، أو تعيد قيمة سلبية ...

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

توازن الدالة compareTo()‎ بين الكائن الذي استُدعي معها والكائن المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية. البنية العامة abstract operator fun compareTo(other: T): Int وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other الكائن الآخر المراد موازنته مع الكائن المعطى. القيمة المعادة تعاد القيمة 0 إن كانت القيمة المعطاة ...

تجلب الدالة getOrNull()‎ محرفًا ذا فهرس مُحدَّد من سلسلة المحارف التي استُدعيت معها أو تعيد القيمة null إن كان الفهرس المعطى يقع خارج حدود سلسلة المحارف. البنية العامة fun CharSequence.getOrNull(index: Int): Char? المعاملات index عدد صحيح يمثل فهرس المحرف المراد جلبه. القيم المعادة يعاد المحرف ذو الفهرس index من سلسلة المحارف المعطاة، أو تعاد القيمة null إن كان الفهرس المعطى يقع خارج حدود سلسلة المحارف. أمثلة مثالٌ على استعمال الدالة ()getOrNull: fun main(args: Array<String>) { val str = "Hsoub" print(str.getOrNull(3)) // => u ...

تحذف الدالة removeSuffix()‎ لاحقة معينة من سلسلة من المحارف أو سلسلة نصية. البنية العامة fun CharSequence.removeSuffix( suffix: CharSequence ): CharSequence fun String.removeSuffix(suffix: CharSequence): String المعاملات suffix سلسلة من المحارف تمثل اللاحقة المراد حذفها. القيم المعادة تعاد سلسلة من المحارف أو سلسلة نصية جديدة تحوي سلسلة المحارف أو السلسلة النصية المعطاة بعد إزالة اللاحقة prefix منها. إن لم تكن اللاحقة suffix موجودة في بداية سلسلة المحارف أو السلسلة النصية المعطاة، فستعاد نسخة عن سلسلة المحارف أو السلسلة النصية تلك. أمثلة ...

 الدوال الموروثة clone يطلق التابع clone()‎ استثناءً (exception) لأنّ ثوابت enum  لا يمكن أن تُنسخ. هذا التابع يمنع الأصناف من النوع Enum من أن ترِث من الصنفCloneable. compareTo تقارن الدالةcompareTo()‎ بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة 0 إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة . equals تبين الدالة equals()‎ إذا ما كان الكائن المُمرّر إليها يساوي ...

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

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

تنشئ الدالة 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 صنف Java الخاص بالكائن (object) الذي تُستدعى عبره أثناء التشغيل (runtime)، وتُعرَّف هذه الخاصية في جميع الأصناف الفرعيّة (sub-classes) من الصنف Any. البنية العامة inline val <T : Any> T.javaClass: Class<T> يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions). القيم المعادة صنف Java الخاصّ بالكائن الذي تُستدعى عبره أثناء التشغيل (runtime). أمثلة تنشِئ الشيفرة الآتية سلسلةً نصيةً باسم a، وتحصل على صنف Java الخاص بها عبر استدعاء ...

تجمع الدالة sumBy()‎ جميع نواتج تطبيق دالة معيَّنة على كل محرف من محارف سلسلة المحارف التي استُدعيت معها. الفرق بين الدالة sumBy()‎ والدالة sumByDouble()‎ هو في نوع القيمة التي تستطيع الدالة الممرَّر إلى كلٍّ منهما إعادتها، إذ تعيد الدالة المُمرَّرة إلى sumBy()‎ عددًّا صحيحًا (integer) بينما يمكن أن تعيد الدالة الممرَّرة إلى sumByDouble()‎ عددًا عشريًّا مضاعفًا (double).  البنية العامة inline fun CharSequence.sumBy(selector: (Char) -> Int): Int يُلاحَظ وجود الكلمة المفتاحية inline التي تدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). المعاملات selector الدالة التي يراد تطبيقها على كل ...

تعيد الخاصية Char.category الفئة العامة للمحرف. البنية العامة val Char.category: CharCategory المنصة المطلوبة: JVM. القيم المعادة تعاد الفئة العامة للمحرف المعطى. مثال استعمال الخاصية Char.category لمعرفة الفئة العامة لعدة محارف: fun main(args: Array<String>) { val x = 'a' val y = 'A' val z = '4' println(x.category) // LOWERCASE_LETTER println(y.category) // UPPERCASE_LETTER println(z.category) // DECIMAL_DIGIT_NUMBER } ...

تتحقق الدالة isBlank()‎ إن كانت سلسلة المحارف التي استٌدعيت معها فارغةً أو تحوي محارف المسافات البيضاء (whitespace characters) فقط. البنية العامة actual fun CharSequence.isBlank(): Boolean القيم المعادة تعاد القيمة true إن كانت سلسلة المحارف التي استٌدعيت معها فارغةً أو تحوي محارف المسافات البيضاء فقط، أو تعاد القيمة false خلاف ذلك. أمثلة مثالٌ على استعمال الدالة isBlank()‎: fun main(args: Array<String>) { val str1 = " hsoub " val str2 = " ...

الأصناف التي ترث من الواجهة Comparable تملك ترتيبًا إجماليًّا مُعرَّفًا بين نُسخِها. interface Comparable<in T> الدوال compareTo توازن الدالة compareTo()‎ بين الكائن الذي استُدعي معها والكائن المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية. الدوال الموروثة equals تحدد الدالة equals()‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معها. hashCode تعيد الدالة hashCode()‎ قيمة ...

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

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

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

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

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

يضبط التابع set()‎ قيمة عنصر ذي فهرس محدد موجود في المصفوفة المستدعاة معه. يمكن الاستعاضة عن هذا التابع باستخدام آلية الإسناد (assignment) ومعامل الفهرسة (index operator) بالشكل: arr[index]‎ = value البنية العامة operator fun set(index: Int, value: Byte) وجود الكلمة المفتاحية operator يدل على أنّ هذا التابع مرتبط بمعامل الفهرسة المذكور سابقًا. المعاملات index عدد صحيح يمثل فهرس العنصر المراد تغيير قيمته وتعيين القيمة value له. value القيمة المراد تعيينها إلى العنصر ذي الفهرس index. أمثلة استعمال التابع set()‎ لتغيير قيمة العنصر الثاني إلى القيمة 98: import java.util.Arrays fun main(args: Array<String>) ...

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

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

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

تنشئ الدالة asSequence()‎ نسخةً من الواجهة Sequence التي تغلّف سلسلة المحارف التي استُدعيت معها لأجل استعمالها في الحلقات التكرارية، إذ تعيد كل محرف من محارفها عندما تُستخدَم في حلقات التكرار (مثل حلقة for). البنية العامة fun CharSequence.asSequence(): Sequence<Char> القيم المعادة كائن من الصنف Sequence التي تغلّف سلسلة المحارف المعطاة لاستعمالها في الحلقات التكرارية. أمثلة تعرّف الشيفرة التالية سلسلة نصية باسم str ثم تستدعي الدالة asSequence()‎ معها وتُحيل القيمة المُعادة إلى المتغير seq ثم نطبَع الناتج باستخدام الحلقة التكرارية for: fun main(args: Array<String>) ...

تعكس الدالة reversed()‎  ترتيب محارف سلسلة المحارف أو السلسلة النصية التي استدعيت معها. البنية العامة fun CharSequence.reversed(): CharSequence inline fun String.reversed(): String وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد سلسلة من المحارف أو سلسلة نصية تحوي جميع محارف سلسلة المحارف أو السلسلة النصية المعطاة بترتيب معكوس. أمثلة مثالٌ على استعمال الدالة ()reversed: fun main(args: Array<String>) { val str = "wikiHsoub" println(str.reversed()) // buosHikiw } انظر ...

تعيد الدالة Array.get()‎ قيمة العنصر في المصفوفة عند الفهرس (index) المُحدَّد، ويمكن أيضًا استدعاء هذه الدالة باستخدام معامل الفهرسة (index operator) المتمثل بالقوسين [] بالشكل: value = arr[index]‎ البنية العامة operator fun get(index: Int): T ويُلاحظ وجود الكلمة المفتاحية operator للدلالة على أنّ هذه الدالة مرتبط بمعامل الفهرسة المذكور سابقًا. المعاملات index عدد صحيح يمثل فهرس العنصر المراد جلبه. القيم المعادة يعاد العنصر عند الفهرس (index) المُحدَّد في المصفوفة. أمثلة تُنشِئ الشيفرة الآتية مصفوفةً من أربعة أعدادٍ صحيحةٍ بالاعتماد على الدالة ...

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

الأصناف التي ترث من الواجهة Comparable تملك ترتيبًا إجماليًّا مُعرَّفًا بين نُسخِها. interface Comparable<in T> الدوال compareTo توازن الدالة compareTo()‎ بين الكائن الذي استُدعي معها والكائن المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية. الدوال الموروثة equals تحدد الدالة equals()‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معها. hashCode تعيد الدالة hashCode()‎ قيمة ...

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

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

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

تحول الدالة capitalize()‎ الحرف الأول للسلسلة النصية التي استُدعيت معها إلى حرف كبير (uppercase). البنية العامة actual fun String.capitalize(): String القيم المعادة تعاد نسخة من السلسلة النصية المعطاة بعد تحويل الحرف الأول فيها إلى حرف كبير، أو تعاد نسخة أخرى من تلك السلسلة النصية إن كان الحرف الأول فيها حرفًا كبيرًا أو كانت السلسلة فارغةً. أمثلة مثالٌ على استعمال الدالة ()capitalize: fun main(args: Array<String>) { println("wiki hsoub".capitalize()) // Wiki hsoub println("Wiki hsoub".capitalize()) // Wiki ...

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

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

تجلب الدالة get()‎ عنصرًا ذي فهرس محدد من المصفوفة. يمكن الاستعاضة عن هذه الدالة باستخدام معامل الفهرسة (index operator) المتمثل بالقوسين [] بالشكل: value = arr[index]‎ البنية العامة operator fun get(index: Int): Float وجود الكلمة المفتاحية operator يدل على أنّ هذه الدالة مرتبط بمعامل الفهرسة الذي ذكرناه آنفًا. المعاملات index عدد صحيح يمثل فهرس العنصر المراد جلبه. القيم المعادة يعاد العنصر ذو الفهرس index المحدِّد والموجود في المصفوفة المعطاة. أمثلة استعمال الدالة get()‎ لجلب العنصر الثالث من مصفوفة من النوع FloatArray: import java.util.Arrays fun main(args: Array<String>) { val int: (Int) ...

تشير القيمة ERROR إلى وجود خطأٍ تولد نتيجة استعمال عنصر مهمل (deprecated element). انظر أيضًا القيمة WARNING: تشير إلى وجود تحذير تولد نتيجة استعمال عنصر مهمل (deprecated element). القيمة HIDDEN: تشير إلى أن العنصر المهمل (deprecated elements) غير متاح للاستخدام ضمن الشيفرة. مصادر صفحة ERROR في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

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

تُزيِل الدالة dropLast()‎ آخر n محرف من محارف السلسلة النصية أو سلسلة المحارف التي استُدعيت معها.   البنية العامة fun CharSequence.dropLast(n: Int): CharSequence fun String.dropLast(n: Int): String المعاملات n عدد صحيح يمثل عدد المحارف المراد حذفها من نهاية السلسلة النصية. القيم المعادة تعاد سلسلة نصية أو سلسلة من المحارف تحوي جميع محارف السلسلة النصية أو سلسلة المحارف المعطاة باستثناء آخر n محرف.  أمثلة مثالٌ على استعمال الدالة ()dropLast: fun main(args: Array<String>) { val str = "wiki Hsoub" println(str.dropLast(0)) // wiki Hsoub ...

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

تمثل الخاصية Char.directionality خاصية الاتجاه في الترميز الموحد (Unicode directionality property) للمحرف الذي استُدعي معها. البنية العامة val Char.directionality: CharDirectionality منصة التشغيل المطلوبة: JVM. القيم المعادة يعاد كائن من النوع CharDirectionality يمثل خاصية الاتجاه في الترميز الموحد للمحرف المعطى. مثال استعمال الخاصية Char.directionality لمعرفة اتجاه عدة محارف: fun main(args: Array<String>) { val x = 'a' val y = 'أ' val z = '4' println(x.directionality) // LEFT_TO_RIGHT ...

يوفّر قيما مُرقّمة (enumeration values) لاستخدامها في تعيين خيارات التعابير النمطية. الخاصيات الموروثة (Inherited Properties) name تعيد الخاصية name اسم الثابت من الكائن enum الذي استُدعيت عبره، كما سُمّيت أُثناء تعريف ذلك الكائن. ordinal تعيد الخاصية ordinal ترتيب الثابت من الكائن enum الذي استُدعيت عبره  enumeration constant‎)‎‎)، أي ترتيبها في تصريح الكائن enum،بحيث تأخذ المُركّبة الأولى العدد 0. الدوال الموروثة clone يطلق التابع clone()‎ استثناءً (exception) لأنّ ثوابت enum  لا يمكن أن تُنسخ. هذا التابع يمنع الأصناف من النوع Enum من أن ترِث من الصنفCloneable. compareTo تقارن الدالةcompareTo()‎ بين قيمة العنصر الذي استُدعيت عبره ...

تنقص الدالة 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 } انظر أيضًا ...

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

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

تعيد الدالة 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 عدد صحيح ...

تشبه الدالة 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 يدل على أن هذه الدالة ...

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

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

تحلّل الدالة 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()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى ...

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

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

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

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

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

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

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

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

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

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