نتائج البحث
اذهب إلى التنقل
اذهب إلى البحث
الدالة contentDeepEquals() في Kotlin
تتحقق الدالة contentDeepEquals() من تساوي مصفوفتين بالعُمق، أي أنهما تحتويان على نفس العناصر وبنفس الترتيب. إن تقابل عنصران وكان كلاهما مصفوفتين متشعبتين، فسيُتحقق من تساويهما بالعمق أيضًا بالطريقة ذاتها. وإن كانت إحدى المصفوفتين تحتوي على مرجع لها (تحتوي على نفسها) في أيّ مستوى من مستويات التشعب، فسيكون سلوك الدالة غير محدَّد. البنية العامة inline infix fun <T> Array<out T>.contentDeepEquals(
other: Array<out T>
): Boolean
الإصدار المطلوب: Kotlin 1.1 وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من ...
الدالة trimEnd() في Kotlin
تحذف الدالة trimEnd() المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من نهاية سلسلة المحارف أو السلسلة النصية التي استُدعيت معها. البنية العامة inline fun CharSequence.trimEnd(
predicate: (Char) -> Boolean
): CharSequence
inline fun String.trimEnd(
predicate: (Char) -> Boolean
): String
fun CharSequence.trimEnd(vararg chars: Char): CharSequence
fun String.trimEnd(vararg chars: Char): String
fun CharSequence.trimEnd(): CharSequence
inline fun String.trimEnd(): String
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات ...
الدالة String.intern() في Kotlin
تعيد الدالة intern() تمثيلًا معياريًّا (canonical representation) للسلسلة النصية التي استُدعيت معها. البنية العامة inline fun String.intern(): String
بيئة التشغيل المطلوبة: JVM. القيم المعادة تعاد سلسلة نصية. أمثلة مثالٌ على استعمال الدالة ()intern: fun main(args: Array<String>) {
var str = "hsoub"
print(str.intern()) // hsoub
}
انظر أيضًا الدالة format(): تنسِّق سلسلة نصية وفقًا لقيمة المعاملات التي تمرر إليها. مصادر صفحة الدالة String.intern() في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.
الصنف Destructured في Kotlin
يوفر الصنف Destructured مركبات الإسناد بالتفكيك (destructuring assignment) لمجموعة من القيم. يسمح الإسناد بالتفكيك باستخراج القيم الموجودة في المصفوفات أو المجموعات أو خاصيات أحد الكائنات ...إلخ. إلى متغيرات مستقلة. تطابق الدالة component1 قيمة المجموعة الأولى، وتطابق الدالة component2 قيمة المجموعة الثانية، وهلم جرًا. إن كانت المجموعة في التعبير النمطي اختيارية ولم ترصد هذه المجموعة أي عملية تطابق تُذكر، فيمكن حينئذٍ أن تساوي قيمة المكون المقابل لهذه المجموعة سلسلةً نصيةً فارغةً. class Destructured
الخاصيات match الدوال component1 component2 component3 component4 component5 component6 component7 ...
الدالة trim() في Kotlin
تحذف الدالة trim() المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من بداية ونهاية سلسلة المحارف أو السلسلة النصية التي استُدعيت معها. البنية العامة inline fun CharSequence.trim(
predicate: (Char) -> Boolean
): CharSequence
inline fun String.trim(predicate: (Char) -> Boolean): String
fun CharSequence.trim(vararg chars: Char): CharSequence
fun String.trim(vararg chars: Char): String
fun CharSequence.trim(): CharSequence
inline fun String.trim(): String
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات predicate دالةٌ تطبق ...
الدالة Byte.div() في Kotlin
تقسِّم الدالة div() العدد الذي استُدعي معه على العدد الممرّر إليها ثم تعيد الناتج. البنية العامة operator fun div(other: Byte): Int
operator fun div(other: Short): Int
operator fun div(other: Int): Int
operator fun div(other: Long): Long
operator fun div(other: Float): Float
operator fun div(other: Double): Double
وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other العدد الآخر المراد تطبيق العملية عليه. القيمة المعادة يعاد ناتج قسمة العدد الذي استُدعي مع الدالة على العدد ...
الدالة component1() في Kotlin
تعيد الدالة component1() العنصر الأول من المصفوفة أو المفتاح (key) لأول زوج (مفتاح/قيمة) في الخريطة (map) التي استدعيت معها. تسمح هذه الدالة باستخدام التصريحات التفكيكية (destructuring declarations) عند العمل على الخرائط. البنية العامة يمكن استدعاء الدالة component1() مع المصفوفات والقوائم (list): inline operator fun <T> Array<out T>.component1(): T
inline operator fun ByteArray.component1(): Byte
inline operator fun ShortArray.component1(): Short
inline operator fun IntArray.component1(): Int
inline operator fun LongArray.component1(): Long
inline operator fun FloatArray.component1(): Float
inline operator fun DoubleArray.component1(): Double
inline operator fun ...
الدالة BooleanArray.set() في Kotlin
يضبط التابع set() قيمة عنصر ذي فهرس محدد موجود في المصفوفة المستدعاة معه. يمكن الاستعاضة عن هذا التابع باستخدام آلية الإسناد (assignment) ومعامل الفهرسة (index operator) بالشكل: arr[index] = value
البنية العامة operator fun set(index: Int, value: Boolean)
وجود الكلمة المفتاحية operator يدل على أنّ هذا التابع مرتبط بمعامل الفهرسة المذكور سابقًا. المعاملات index عدد صحيح يمثل فهرس العنصر المراد تغيير قيمته وتعيين القيمة value له. value القيمة المراد تعيينها إلى العنصر ذي الفهرس index. أمثلة استعمال التابع set() لتغيير قيمة العنصر الثاني إلى ...
الدالة CharSequence.chunkedSequence() في Kotlin
تقطِّع الدالة chunkedSequence() سلسلة المحارف التي استُدعيت معها إلى عدة أجزاء لا يتجاوز كل منها حجمًا معينًا وتعيدها في سلسلة أو تطبِّق دالة معينة على كل منها وتضع الناتج الذي تعيده هذه الدالة في سلسلة. البنية العامة fun CharSequence.chunkedSequence(size: Int): Sequence<String>
fun <R> CharSequence.chunkedSequence(
size: Int,
transform: (CharSequence) -> R
): Sequence<R>
بيئة التشغيل المطلوبة: Kotlin 1.2. المعاملات size عدد صحيح يمثل عدد العناصر المراد اقتطاعها ووضعها في كل سلسلة نصية. يجب أن يكون هذا ...
الدالة Float.toDouble() في Kotlin
تحوّل الدالة toDouble() العدد العشري الذي استُدعي معها إلى عدد عشري مضاعف (أي من النوع Double). هذا قد يؤدي إلى تدوير العدد المراد تحويله. البنية العامة fun toDouble(): Double
حلت الدالة Number.toDouble() مكان هذه الدالة. القيمة المعادة يعاد عدد عشري مضاعف (من النوع Double) يحوي العدد العشري المعطى المراد تحويله. أمثلة استعمال الدالة ()toDouble لتحويل عدد عشري إلى عدد عشري مضاعف: fun main(args: Array<String>) {
val x : Float = 52.44f
println(x.toDouble() ...
الدالة toSortedSet() في Kotlin
تحول الدالة toSortedSet() المصفوفة أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع SortedSet ثمَّ تعيدها فقط إن لم يمرَّر إليها أي شيء، أو ترتِّبها وفقًا لترتيب معيَّن ثمَّ تعيدها إن مرِّرت إليها دالة مقارنة. البنية العامة يمكن استدعاء الدالة toSortedSet() مع المصفوفات أو المجموعات التكرارية: fun <T : Comparable<T>> Array<out T>.toSortedSet(): SortedSet<T>
fun ByteArray.toSortedSet(): SortedSet<Byte>
fun ShortArray.toSortedSet(): SortedSet<Short>
fun IntArray.toSortedSet(): SortedSet<Int>
fun LongArray.toSortedSet(): SortedSet<Long>
fun FloatArray.toSortedSet(): SortedSet<Float>
fun DoubleArray.toSortedSet(): SortedSet<Double>
fun BooleanArray.toSortedSet(): SortedSet<Boolean>
fun CharArray.toSortedSet(): SortedSet<Char>
fun <T : Comparable<T>> ...
الخاصية javaClass في Kotlin
تعيد الخاصيّة javaClass صنف Java الخاص بالكائن (object) الذي تُستدعى عبره أثناء التشغيل (runtime)، وتُعرَّف هذه الخاصية في جميع الأصناف الفرعيّة (sub-classes) من الصنف Any. البنية العامة inline val <T : Any> T.javaClass: Class<T>
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions). القيم المعادة صنف Java الخاصّ بالكائن الذي تُستدعى عبره أثناء التشغيل (runtime). أمثلة تنشِئ الشيفرة الآتية سلسلةً نصيةً باسم a، وتحصل على صنف Java الخاص بها عبر استدعاء ...
الدالة filterIndexed() في Kotlin
ترشِّح الدالة filterIndexed() محارف سلسلة المحارف أو السلسلة النصية المعطاة بناءً على فهرس المحرف وقيمته. البنية العامة inline fun CharSequence.filterIndexed(
predicate: (index: Int, Char) -> Boolean
): CharSequence
inline fun String.filterIndexed(
predicate: (index: Int, Char) -> Boolean
): String
وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (لمزيد من التفاصيل، راجع توثيق الدوال المباشرة). المعاملات predicate دالةٌ تمثل الشرط المراد تطبيقه على كل محرف من محارف السلسلة النصية أو سلسلة المحارف المعطاة. يمرر إلى هذه الدالة فهرس المحرف وقيمته أيضًا وتعيد قيمة ...
الدالة contentEquals() في Kotlin
تتحقَّق الدالة contentEquals() من تساوي مصفوفتين بنيويًا (structurally equal)، أي إن كان لهما نفس العناصر وبنفس العدد والترتيب. البنية العامة inline infix fun <T> Array<out T>.contentEquals(
other: Array<out T>
): Boolean
inline infix fun ByteArray.contentEquals(
other: ByteArray
): Boolean
inline infix fun ShortArray.contentEquals(
other: ShortArray
): Boolean
inline infix fun IntArray.contentEquals(
other: IntArray
): Boolean
inline infix fun LongArray.contentEquals(
other: LongArray
): Boolean
inline infix fun FloatArray.contentEquals(
other: ...
الدالة FloatArray.set() في Kotlin
تضبط الدالة set() قيمة عنصر ذي فهرس محدد موجود في المصفوفة المستدعاة معه. يمكن الاستعاضة عن هذه الدالة باستخدام آلية الإسناد (assignment) ومعامل الفهرسة (index operator) بالشكل: arr[index] = value
البنية العامة operator fun set(index: Int, value: Float)
وجود الكلمة المفتاحية operator يدل على أنّ هذه الدالة مرتبط بمعامل الفهرسة المذكور سابقًا. المعاملات index عدد صحيح يمثل فهرس العنصر المراد تغيير قيمته وتعيين القيمة value له. value القيمة المراد تعيينها إلى العنصر ذي الفهرس index. أمثلة استعمال الدالة set() لتغيير قيمة العنصر الثاني والثالث إلى 5.34 و 98.5 على ...
الدالة toIntOrNull() في Kotlin
تحلّل الدالة toIntOrNull() السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح. البنية العامة fun String.toIntOrNull(): Int?
تحلّل الدالة toIntOrNull() السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح. في حال لم تكن السلسلة النصية تمثل عددًا، تعيد الدالة القيمة null. fun String.toIntOrNull(radix: Int): Int?
بيئة التشغيل المطلوبة: Kotlin 1.1. تحلّل الدالة toIntOrNull() السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح. في حال لم تكن السلسلة النصية تمثل عددًا، تعيد الدالة القيمة null. أما في حال كان المعامل radix المعطى أساسًا غير صالح لتحويل السلسلة ...
الدالة CharSequence.get() في Kotlin
تجلب الدالة get() المحرف ذا الفهرس الممرَّر إليها من سلسلة المحارف المستدعاة معها. البنية العامة abstract operator fun get(index: Int): Char
وجود الكلمة المفتاحية operator يدل على أنّ هذا التابع مرتبط بمعامل الفهرسة []. المعاملات index عدد صحيح يمثل فهرس المحرف المراد جلبه. القيمة المعادة يعاد العنصر ذو الفهرس index الموجود في سلسلة الحروف المعطاة. أمثلة استعمال الدالة get() لجلب الحرف الرابع من سلسلة الحروف "hsoub": fun main(args: Array<String>) {
val s = "hsoub"
println(s.get(3)) // u, or
...
الدالة toSet() في Kotlin
تضيف الدالة toSet() كل محارف سلسلة الحروف التي استٌدعيت معها إلى مجموعة من النوع Set، إذ يوضع كل محرف في عنصر. تحافظ المجموعة المُعادة على ترتيب التكرار (element iteration order) في سلسلة المحارف الأصلية. البنية العامة fun CharSequence.toSet(): Set<Char>
القيم المعادة تعاد مجموعة من النوع Set تحوي كل محارف السلسلة المعطاة. أمثلة مثالٌ على استعمال الدالة toSet(): fun main(args: Array<String>) {
println("Hello, world!".toSet()) // [H, e, l, o, ,, , w, r, d, !]
...
الدالة asList() في Kotlin
تُعيد الدالة asList() قائمةً (list) تُغلّف المصفوفة الأصلية التي استُدعيت عبرها. البنية العامة تختلف بحسب نوع المصفوفة: fun <T> Array<out T>.asList(): List<T>
fun ByteArray.asList(): List<Byte>
fun ShortArray.asList(): List<Short>
fun IntArray.asList(): List<Int>
fun LongArray.asList(): List<Long>
fun FloatArray.asList(): List<Float>
fun DoubleArray.asList(): List<Double>
fun BooleanArray.asList(): List<Boolean>
fun CharArray.asList(): List<Char>
القيم المعادة قائمة (list) تُغلّف المصفوفة الأصلية التي استُدعيت عبرها. أمثلة تعرِّف الشيفرة الآتية مصفوفةً باسم array مكوَّنة من حرفين باستخدام الدالة ()arrayOf، ثم تنشئ قائمةً باسم list من المصفوفة array وذلك باستخدام الدالة ()asList ...
الواجهة Appendable في Kotlin
actual typealias Appendable = Appendable
المنصة والإصدار المطلوبان: Kotlin 1.1، JVM. actual interface Appendable
المنصة المطلوبة: JS. الدوال append تضيف هذه الدالة المحرف الممرر إليها أو كامل محتوى الكائن المُمرّر إليها أو جزءًا منه إلى الكائن المستدعى معها. الدوال الموروثة equals تتحقق هذه الدالة إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعي معها. hashCode تعيد هذه الدالة الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. toString تحول هذه الدالة الكائن الذي يُستدعى معه إلى سلسلة نصية (String). مصادر صفحة الواجهة Appendable في التوثيق ...
الصنف StringBuilder في Kotlin
actual typealias StringBuilder = StringBuilder
منصة التشغيل والإصدار المطلوبان: JVM ،Kotlin 1.1 actual class StringBuilder : Appendable, CharSequence
منصة التشغيل المطلوبة: JS. الدوال البانية (Constructors) <init> تنشئ الدالة StringBuilder() كائنًا من النوع StringBuilder. الخاصيات length تمثل هذه الخاصية حجم الكائن StringBuilder (عدد محارفه) الذي استدعي معها. الدوال append تضيف هذه الدالة محرفًا أو سلسلة نصية أو أيَّ كائن آخر إلى الكائن StringBuilder. get تجلب هذه الدالة محرفًا ذا فهرس محدَّدٍ من سلسلة محارف الكائن StringBuilder. reverse تعكس هذه الدالة ترتيب محارف الكائن StringBuilder. subSequence تقتطع هذه الدالة جزءًا محددًا من سلسلة محارف الكائن StringBuilder وتعيدها. toString تحول هذه ...
الدالة Text.startsWith() في Kotlin
تتحقق الدالة startsWith() إن كانت السلسلة النصية أو سلسلة المحارف التي استُدعيت معها تبدأ بمحرف معين أو لاحقة معينة. البنية العامة fun String.startsWith(
prefix: String,
ignoreCase: Boolean = false
): Boolean
fun CharSequence.startsWith(
prefix: CharSequence,
ignoreCase: Boolean = false
): Boolean
تتحقق الدالة startsWith() إن كانت السلسلة النصية أو سلسلة المحارف التي استُدعيت معها تبدأ بالبادئة prefix. fun String.startsWith(
prefix: String,
startIndex: Int, ...
الواجهة MatchNamedGroupCollection في Kotlin
توسع هذه الواجهة الصنف MatchGroupCollection عبر تعريف طريقةٍ لجلب المجموعات المتطابقة (matched groups) عن طريق أسمائها عندما يدعم Regex ذلك. interface MatchNamedGroupCollection : MatchGroupCollection
الإصدار المطلوب: kotlin 1.1. الدوال (Functions) get تعيد هذه الدالة نسخةً من الصنف MatchGroup إن كانت المجموعة التي تحمل الاسم المُمرّر إليها متطابقَة. الدوال الموروثة (Inherited Functions) get تعيد هذه الدالة نسخةً من الصنف MatchGroup إن كانت المجموعة التي تحمل الاسم المُمرّر إليها متطابقَة. الخاصيات الإضافية (Extension Properties) indices تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection). الدوال ...
الصنف Double في Kotlin
يمثل الصنف Double عددًا عشريًّا مضاعفًا (دقة مضاعفة للأعداد بعد الفاصلة [double-precision floating point]) بحجم 64 بت مطابقًا للمعيار IEEE 754. في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثَّل كقيم للنوع double الأساسي. class Double : Number, Comparable<Double>
الدوال compareTo توازن الدالة compareTo() بين عدد عشري مضاعف (double) وعدد آخر ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كان العدد الأول (العدد الذي استُدعي مع الدالة) أصغر من العدد الثاني الممرر إليها، أو قيمة موجبة إن كان العدد الأول أكبر ...
الواجهة Annotation في Kotlin
هي الواجهة الأساسيّة التي يُعرَّف استخدامها (implemented) ضمنيًا في جميع واجهات التوصيفات (annotation interfaces)، وللمزيد من التفاصيل راجع التوصيفات (annotations) في لغة Kotlin. interface Annotation
الدوال المورثة (Inherited Functions) equals تتحقق الدالة equals() إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معه. hashCode تعيد الدالة hashCode() الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. toString تحول الدالة toString() الكائن الذي يُستدعى معه إلى سلسلة نصية (String). الخاصيات الإضافية (Extension Properties) annotationClass تُستخدَم هذه الخاصيّة للحصول على نسخةٍ (instance) من الصنف KClass بحسب نوع التوصيف الحاليّ. ...
الدالة Char.minus() في Kotlin
تطرح الدالة minus() القيمة العددية للمحرف الممرّر إليها من القيمة العددية للمحرف المستدعى معها ثمَّ تعيد عددًا من النوع Int يمثل الناتج. وإن مرِّر إليها عدد صحيح من النوع Int، فستعيد المحرف الذي تساوي قيمته العددية حاصل طرح هذا العدد من القيمة العددية للحرف الذي استُدعيت معه. البنية العامة operator fun minus(other: Char): Int
operator fun minus(other: Int): Char
وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other محرفٌ أو عددٌ صحيحٌ يراد طرحه من المحرف ...
الثابت Double.NEGATIVE_INFINITY في Kotlin
يمثّل الثابت Double.NEGATIVE_INFINITY قيمة سالبة لا نهائية (infinity) لعدد عشري مضاعف (double). البنية العامة val NEGATIVE_INFINITY: Double
أمثلة استخدام الثابت Double.NEGATIVE_INFINITY لطباعة قيمة سالبة لا نهائية لعدد عشري مضاعف: fun main(args: Array<String>) {
println(Double.NEGATIVE_INFINITY) // -Infinity
}
انظر أيضًا الثابت Double.MAX_VALUE: يمثل أكبر قيمة موجبة نهائية (finite) لعدد عشري مضاعف (double). الثابت Double.MIN_VALUE: يمثل أًصغر قيمة موجبة غير صفرية يمكن أن يأخذها عدد عشري مضاعف (double). الثابت Double.POSITIVE_INFINITY: يمثل قيمة موجبة لا نهائية (infinity) ...
الدالة regionMatches() في Kotlin
تتحقق الدالة regionMatches() من مطابقة جزأين من سلسلتين نصيتين أو سلسلتين من المحارف محددين ببداية وطول مع بعضهما بعضًا. البنية العامة actual fun CharSequence.regionMatches(
thisOffset: Int,
other: CharSequence,
otherOffset: Int,
length: Int,
ignoreCase: Boolean = false
): Boolean
fun String.regionMatches(
thisOffset: Int,
other: String,
otherOffset: Int,
length: Int, ...
الدالة sortWith() في Kotlin
ترتِّب الدالة sortWith() جميع عناصر المصفوفة أو القائمة المتغيرة (MutableList) التي استُدعيت معها أو جزءًا محدَّدًا منها تنازليًا وفقًا للمُقارن المُمرّر إليها. البنية العامة إن استدعيت الدالة sortWith() مع تمرير مقارِن comparator، فسترتِّب جميع عناصر المصفوفة أو القائمة المتغيرة التي استُدعيت معها وفقًا للترتيب الذي يحدده هذا المقارن المعطى: fun <T> Array<out T>.sortWith(comparator: Comparator<in T>)
fun <T> MutableList<T>.sortWith(comparator: Comparator<in T>)
أمَّا إن استدعيت الدالة مع تمرير مقارِن comparator والعددين fromIndex و toIndex، فسترتب المجال الذي يحدده هذين العددين من المصفوفة التي استُدعيت ...
الدالة Float.times() في Kotlin
تضرب الدالة times() العدد الممرّر إليها بالعدد العشري (float) المستدعى معها ثمَّ تعيد الناتج. البنية العامة operator fun times(other: Byte): Float
operator fun times(other: Short): Float
operator fun times(other: Int): Float
operator fun times(other: Long): Float
operator fun times(other: Float): Float
operator fun times(other: Double): Double
وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other العدد الآخر الذي ستُجرَى عليه العملية. القيمة المعادة يعاد عدد عشري يحوي ناتج ضرب العدد other الممرّر بالعدد العشري المعطى. إن كان نوع ...
الدالة Regex.matches() في Kotlin
تتحقق الدالة matches() من مطابقة جميع محارف السلسلة الممررة إليها مع التعبير النمطي الذي استدعي معها. البنية العامة infix actual fun matches(input: CharSequence): Boolean
وجود الكلمة المفتاحية infix يدل على إمكانية استدعاء الدالة بنمط التدوين الداخلي (Infix notation)؛ أي من خلال حذف المعامل . والأقواس () المُستخدَمَين في الاستدعاء عادةً. المعاملات input سلسلة من المحارف التي يراد أن يُتحقَق من مطابقتها كلِّيًا لتعبير نمطي معين. القيمة المعادة تعاد القيمة true إن تطابقت جميع محارف السلسلة input مع التعبير النمطي المعطى. أمثلة استعمال الدالة matches() للتحقق من مطابقة ...
الدالة CharSequence.maxBy() في Kotlin
تجلب الدالة maxBy() المحرف من السلسلة التي استُدعيت معها والذي أعيدت معه أكبر قيمة عند تطبيق دالة معيَّنة عليه. البنية العامة inline fun <R : Comparable<R>> CharSequence.maxBy(
selector: (Char) -> R
): Char?
وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات selector دالةٌ تطبَّق على كل محرف من محارف السلسلة المعطاة. يمرر إليها المحرف، وتعيد قيمة مقابلة له. القيم المعادة يعاد المحرف من السلسلة المعطاة والذي أعطى أكبر قيمة عند تطبيق الدالة selector عليه، أو ...
الدالة toLongArray() في Kotlin
تحول الدالة toLongArray() المصفوفة العامة (أي من النوع Array<Long>) أو المجموعة التي استُدعيت معها إلى مصفوفة من النوع LongArray. البنية العامة fun Array<out Long>.toLongArray(): LongArray
fun Collection<Long>.toLongArray(): LongArray
القيمة المعادة تعاد مصفوفة من النوع LongArray تحوي جميع عناصر المصفوفة العامة (أي من النوع Array<Long>) أو المجموعة المعطاة. أمثلة استعمال الدالة ()toLongArray لتحويل مصفوفة من النوع Array<Long> إلى النوع LongArray: import java.util.Arrays
fun main(args: Array<String>) {
val array: Array<Long> = arrayOf(4, 5, 6)
println(Arrays.toString(array.toLongArray())) // [4, 5, 6]
...
الدالة Char.toShort() في Kotlin
تحوّل الدالة toShort() المحرف الذي استُدعي معها إلى عدد من النوع Short. البنية العامة fun toShort(): Short
القيمة المعادة يعاد عدد من النوع Short يمثِّل القيمة العددية للمحرف المعطى. أمثلة استعمال الدالة ()toShort لتحويل المحرف 'a' إلى عدد من النوع Short: fun main(args: Array<String>) {
val x = 'a'
print(x.toShort() ) // 97
}
انظر أيضًا الدالة toByte() : تحوّل المحرف الذي استُدعي معها إلى عدد من النوع ...
الدالة toLong() في Kotlin
تحلّل الدالة toLong() السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد طويل. البنية العامة inline actual fun String.toLong(): Long
تحلّل الدالة toLong() السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد طويل. في حال لم تكن السلسلة النصية تمثل عددًا، فسيُطلَق الاستثناء NumberFormatException. inline actual fun String.toLong(radix: Int): Long
الإصدار المطلوب: Kotlin 1.1. تحلّل الدالة toLong() السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد طويل. في حال لم تكن السلسلة النصية تمثل عددًا، فسيُطلَق الاستثناء NumberFormatException. أما في حال كان المعامل radix المعطى أساسًا غير صالح ...
الدالة subSequence() في Kotlin
تعيد الدالة subSequence() جزءًا محددًا من سلسلة المحارف التي استُدعيت معها. البنية العامة fun CharSequence.subSequence(range: IntRange): CharSequence
inline fun String.subSequence(
start: Int,
end: Int
): CharSequence
هذا الشكل من الدالة قد أُهمِل. المعاملات range مجال من النوع IntRange يحدد الجزء المراد جلبه من سلسلة المحارف المعطاة. start عدد صحيح يشير إلى فهرس العنصر الذي يمثل بداية المجال المراد جلبه. end عدد صحيح يشير إلى فهرس العنصر الذي يمثل نهاية المجال المراد جلبه. القيم المعادة تعاد ...
الدالة CharSequence.count() في Kotlin
تَعُدُّ الدالة count() جميع محارف سلسلة المحارف التي استُدعيت معها، أو المحارف المحققة لشرط معين. البنية العامة inline fun CharSequence.count(): Int
inline fun CharSequence.count(
predicate: (Char) -> Boolean
): Int
وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). المعاملات predicte دالةٌ تمثل شرط معين يطبق على كل محرف من محارف السلسلة النصية المعطاة، وتعيد مع كل واحد منها قيمة منطقية. القيم المعادة يعاد عدد صحيح يمثل عدد محارف السلسلة المعطاة ...
الدالة CharSequence.lastIndexOfAny() في Kotlin
تجلب الدالة lastIndexOfAny() فهرس آخر ظهور لأيٍّ منه المحارف أو السلاسل النصية المعطاة من سلسلة المحارف التي استُدعيت معها. البنية العامة fun CharSequence.lastIndexOfAny(
chars: CharArray,
startIndex: Int = lastIndex,
ignoreCase: Boolean = false
): Int
fun CharSequence.lastIndexOfAny(
strings: Collection<String>,
startIndex: Int = lastIndex,
ignoreCase: Boolean = false
): Int
المعاملات chars مصفوفة من المحارف التي يراد البحث عنها ضمن سلسلة المحارف المعطاة. strings مجموعةٌ من سلاسل نصية ...
الدالة forEachIndexed() في Kotlin
تُنفّد الدالةُ forEachIndexed() الدالةَ المُمرّرةَ إليها على كل عنصر من عناصر المصفوفة، أو المجموعة، أو الخريطة، التي استُدعيت معها وعلى فهرس ذلك العنصر. البنية العامة inline fun <T> Array<out T>.forEachIndexed(
action: (index: Int, T) -> Unit)
inline fun ByteArray.forEachIndexed(
action: (index: Int, Byte) -> Unit)
inline fun ShortArray.forEachIndexed(
action: (index: Int, Short) -> Unit)
inline fun IntArray.forEachIndexed(
action: (index: Int, Int) -> Unit)
inline fun LongArray.forEachIndexed(
...
الدالة groupBy() في Kotlin
تجمِّع الدالة groupBy() عناصر المصفوفة أو المجموعة التي استُدعيت معها في مجموعات، إذ تطبق دالة محدَّدة على كل عنصر ثمَّ تعاد خريطة تحوي مجموعاتٍ مفتاحُ كلِّ واحدةٍ منها مرتبطٌ بقائمة من العناصر المقابلة. تحافظ الخريطة المُعادة على على ترتيب التكرار (entry iteration order) للمفاتيح الناتجة عن المصفوفة أو المجموعة الأصلية. البنية العامة إن مُرِّر إلى الدالة groupBy() المعامل keySelector فقط، فستُجمّع عناصر المصفوفة أو المجموعة المعطاة بحسب المفتاح الذي تعيده الدالة keySelector() المطبقة على كل عنصر من تلك العناصر ثمَّ ...
الدالة toHashSet() في Kotlin
تعيد الدالة toHashSet() كائنًا من النوع HashSet يحوي كل محارف السلسلة التي استٌدعيت معها. البنية العامة fun CharSequence.toHashSet(): HashSet<Char>
القيم المعادة يعاد كائن من النوع HashSet يحوي كل محارف السلسلة المعطاة. أمثلة مثالٌ على استعمال الدالة toHashSet(): fun main(args: Array<String>) {
println("hsoub".toHashSet()) // [h, b, s, u, o]
println("32.87".toHashSet()) // [8, 2, 3, ., 7]
println("wiki".toHashSet()) // [i, k, w]
}
...
الدالة String.decapitalize() في Kotlin
تحول الدالة decapitalize() الحرف الأول للسلسلة النصية التي استُدعيت معها إلى حرف صغير (lowercase). البنية العامة actual fun String.decapitalize(): String
القيم المعادة تعاد نسخة من السلسلة النصية المعطاة بعد تحويل الحرف الأول فيها إلى حرف صغير، أو تعاد نسخة أخرى من تلك السلسلة النصية إن كان الحرف الأول فيها حرفًا صغيرًا أو كانت السلسلة فارغةً. أمثلة مثالٌ على استعمال الدالة ()decapitalize: fun main(args: Array<String>) {
println("abcd".decapitalize()) // abcd
println("Abcd".decapitalize()) // abcd
}
انظر أيضًا الدالة ...
الدالة Char.toByte() في Kotlin
تحوّل الدالة toByte() المحرف الذي استُدعي معها إلى عدد من النوع Byte. البنية العامة fun toByte(): Byte
القيمة المعادة يعاد عدد من النوع Byte يمثل القيمة العددية للمحرف المعطى. أمثلة استعمال الدالة ()toByte لتحويل المحرف 'a' إلى قيمته العددية: fun main(args: Array<String>) {
val x = 'a'
println(x.toByte()) // 97
}
انظر أيضًا الدالة toChar(): تحول القيمة العددية للمحرف الذي استُدعي معها إلى محرف (أي من النوع Char). ...
الدالة toUpperCase() في Kotlin
تحوّل الدالة toUpperCase() المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف كبيرة (uppercase). البنية العامة inline actual fun Char.toUpperCase(): Char
inline actual fun String.toUpperCase(): String
inline fun String.toUpperCase(locale: Locale): String
المنصة المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). المعاملات locale المحلية المراد ضبطها إلى منطقة جغرافية محددة وأخذها بالحسبان أثناء عملية التحويل. القيم المعادة يعاد المحرف Char المعطى بعد تحويله إلى محرف كبير، أو السلسلة النصية ...
الدالة slice() في Kotlin
تقطع الدالة slice() جزءًا محدَّدًا من المصفوفة أو القائمة التي استُدعيت معها ثمَّ تعيده في قائمة. البنية العامة يمكن تمرير مجال محدَّد إلى الدالة slice() كوسيط: fun <T> Array<out T>.slice(indices: IntRange): List<T>
fun ByteArray.slice(indices: IntRange): List<Byte>
fun ShortArray.slice(indices: IntRange): List<Short>
fun IntArray.slice(indices: IntRange): List<Int>
fun LongArray.slice(indices: IntRange): List<Long>
fun FloatArray.slice(indices: IntRange): List<Float>
fun DoubleArray.slice(indices: IntRange): List<Double>
fun BooleanArray.slice(indices: IntRange): List<Boolean>
fun CharArray.slice(indices: IntRange): List<Char>
fun <T> List<T>.slice(indices: IntRange): List<T>
أو يمكن تمرير كائن من النوع Iterable إلى الدالة slice() كوسيط: fun <T> Array<out T>.slice(indices: Iterable<Int>): ...
الدالة Byte.unaryPlus() في Kotlin
تعيد الدالة unaryPlus() القيمة التي استدعيت معها. البنية العامة operator fun unaryPlus(): Int
وجود الكلمة المفتاحيّة operator يدل على أنّ هذه الدالة مرتبطٌة بمعامل تكرار (iteration operator). القيمة المعادة تعاد القيمة نفسها المعطاة. أمثلة استعمال الدالة ()unaryPlus لإعادة القيمة المستدعاة معها: fun main(args: Array<String>) {
val x: Byte = 52
println(x.unaryPlus()) // 52
}
انظر أيضًا الدالة unaryMinus(): تعيد القيمة السالبة المقابلة للقيمة التي استُدعيت معها. الدالة inc(): تزيد القيمة التي استُدعيت معها بمقدار 1 ثم تعيد القيمة ...
الدالة CharSequence.commonPrefixWith() في Kotlin
تعيد الدالة commonPrefixWith() أطول بادئة (prefix) مُشتركة بين سلسلة المحارف التي استُدعيت معها وسلسلة المحارف المُمرّرة إليها. تأخذ الدالة بالحسبان ألا تقتطع الأزواج البديلة (surrogate pairs) عند جلب البادئة المشتركة تلك. البنية العامة fun CharSequence.commonPrefixWith(
other: CharSequence,
ignoreCase: Boolean = false
): String
المعاملات Other سلسلة المحارف التي يراد جلب البادئة المشتركة بينها وبين سلسلة المحارف المعطاة. ignoreCase قيمة منطقية تحدد إن كان يراد تجاهل حالة الحروف أم لا أثناء البحث عن بادئة مشتركة. ...
الدالة distinct() في Kotlin
تحذف الدالة distinct() العناصر المتكررة الموجودة في المصفوفة أو المجموعة التي استُدعيت معها وتعيد الناتج في قائمة. تُرتَّب العناصر في القائمة الناتجة بنفس ترتيبها في المصفوفة أو المجموعة الأصليَّة. البنية العامة تستدعى الدالة distinct() مع مصفوفة: fun <T> Array<out T>.distinct(): List<T>
fun ByteArray.distinct(): List<Byte>
fun ShortArray.distinct(): List<Short>
fun IntArray.distinct(): List<Int>
fun LongArray.distinct(): List<Long>
fun FloatArray.distinct(): List<Float>
fun DoubleArray.distinct(): List<Double>
fun BooleanArray.distinct(): List<Boolean>
fun CharArray.distinct(): List<Char>
وتستدعى مع مجموعة: fun <T> Iterable<T>.distinct(): List<T>
القيم المعادة تُعاد قائمة تحتوي على عناصر المصفوفة ...
الدالة toString() في Kotlin
تحول الدالة toString() العدد الذي استٌدعي معها وفقًا لأساس مُحدّد إلى سلسلة نصية. البنية العامة inline actual fun Byte.toString(radix: Int): String
inline actual fun Short.toString(radix: Int): String
inline actual fun Int.toString(radix: Int): String
inline actual fun Long.toString(radix: Int): String
الإصدار المطلوب: Kotlin 1.1. يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات radix عدد صحيح بين 2 و 36 الذي يُمثِّل الأساس المستعمل في تحويل القيمة العددية إلى سلسلة نصية؛ لاستخدام نظام العد العشري (decimal) ...
الدالة padEnd() في Kotlin
تحشو الدالة padEnd() نهاية سلسلة نصية أو سلسلة من المحارف بمحرف محدد. البنية العامة fun CharSequence.padEnd(
length: Int,
padChar: Char = ' '
): CharSequence
fun String.padEnd(length: Int, padChar: Char = ' '): String
وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات length طول اللاحقة المراد ملؤها بالمحرف padChar. padChar المحرف المراد إضافته إلى نهاية سلسلة من المحارف أو سلسلة نصية. القيمة الافتراضية له هي: ' ' ...
الدالة isDigit() في Kotlin
تتحقق الدالة isDigit() إن كان المحرف الذي استٌدعيت معه رقمًا أم لا. البنية العامة inline fun Char.isDigit(): Boolean
المنصة المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن حال كان المحرف المعطى رقمًا، أو القيمة false خلاف ذلك. أمثلة استعمال الدالة isDigit() للتحقق من عدَّة محارف إن كانت رقمًا أم لا: fun main(args: Array<String>) {
val x = 'a'
...
الدالة reduceIndexed() في Kotlin
تجمع الدالة reduceIndexed() ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليسار إلى اليمين) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي والقيمة المجمَّعة الحالية. البنية العامة يمكن استدعاء الدالة reduceIndexed() مع المصفوفات: inline fun <S, T : S> Array<out T>.reduceIndexed(
operation: (index: Int, acc: S, T) -> S
): S
inline fun ByteArray.reduceIndexed(
operation: (index: Int, acc: Byte, Byte) -> Byte
): Byte
inline fun ShortArray.reduceIndexed(
...
الدالة maxBy() في Kotlin
تجلب الدالة maxBy() العنصر أو الزوج الأول من المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها والذي أعيدت معه أكبر قيمة عند تطبيق دالة معيَّنة عليه. البنية العامة يمكن استدعاء الدالة maxBy() مع المصفوفات و المجموعات والخرائط: inline fun <T, R : Comparable<R>> Array<out T>.maxBy(
selector: (T) -> R
): T?
inline fun <R : Comparable<R>> ByteArray.maxBy(
selector: (Byte) -> R
): Byte?
inline fun <R : Comparable<R>> ShortArray.maxBy(
selector: (Short) -> R
): ...
الدالة toBooleanArray() في Kotlin
تحول الدالة toBooleanArray() المصفوفة العامة (أي من النوع Array<out Boolean>) أو المجموعة التي استُدعيت معها إلى مصفوفة من قيم منطقية (أي من النوع BooleanArray) . البنية العامة fun Array<out Boolean>.toBooleanArray(): BooleanArray
fun Collection<Boolean>.toBooleanArray(): BooleanArray
القيمة المعادة تعاد مصفوفة من القيم المنطقية (من النوع BooleanArray) تحوي جميع عناصر المصفوفة العامة (من النوع Array<out Boolean>) أو المجموعة المعطاة. أمثلة استعمال الدالة ()toBooleanArray لتحويل مصفوفة من النوع Array<Boolean> إلى النوع BooleanArray: import java.util.Arrays
fun main(args: Array<String>) {
val array: Array<Boolean> = arrayOf(true, true, false)
...
الدالة CharSequence.groupByTo() في Kotlin
تشبه الدالة groupByTo() الدالة groupBy() في جميع النواحي باستثناء أنَّها تضيف الناتج المعاد إلى المعامل الممرَّر إليها. البنية العامة inline fun <K, M : MutableMap<in K, MutableList<Char>>> CharSequence.groupByTo(
destination: M,
keySelector: (Char) -> K
): M
inline fun <K, V, M : MutableMap<in K, MutableList<V>>> CharSequence.groupByTo(
destination: M,
keySelector: (Char) -> K,
valueTransform: (Char) -> V
): M
إن مُرِّر إلى الدالة groupBy() المعامل destination والمعامل keySelector فقط، فستُجمّع محارف السلسلة المعطاة بحسب المفتاح الذي تعيده الدالة ...
الدالة isWhitespace() في Kotlin
تتحقق الدالة isWhitespace() إن كان المحرف الذي استٌدعي معها هو مسافة بيضاء (whitespace). البنية العامة actual fun Char.isWhitespace(): Boolean
القيم المعادة تعاد القيمة true إن كان المحرف الذي استٌدعي معها هو مسافة بيضاء، أو القيمة false خلاف ذلك. أمثلة استعمال الدالة isWhitespace() لمعرفة أي المحرفين التاليين هو مسافة بيضاء: fun main(args: Array<String>) {
val x = '_'
val y = ' '
print(x.isWhitespace()) // false
...
الدالة Regex.split() في Kotlin
تقتطع الدالة split() المحارف الموجودة بين الأجزاء المتطابقة مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف الممررة إليها. البنية العامة actual fun split(
input: CharSequence,
limit: Int = 0
): List<String>
المعاملات input سلسلة المحارف المراد اقتطاع الأجزاء المجاورة لتلك المتطابقة مع تعبير نمطي وجلبها. limit عدد صحيح موجب يحدد الحد الأقصى لعدد الأجزاء المقتطعة المراد جلبها. قيمته الافتراضية هي: 0 أي لا يوجد حد أقصى. القيمة المعادة تعاد قائمة تضم المحارف الموجودة ...
الدالة filter() في Kotlin
ترشِّح الدالة filter() عناصر المصفوفة أو المجموعة أو أزواج الخرائط المعطاة التي تحقِّق شرطًا معيَّنًا ثمّ تعيدها. البنية العامة يمكن استدعاء الدالة filter() مع المصفوفات والمجموعات: inline fun <T> Array<out T>.filter(
predicate: (T) -> Boolean
): List<T>
inline fun ByteArray.filter(
predicate: (Byte) -> Boolean
): List<Byte>
inline fun ShortArray.filter(
predicate: (Short) -> Boolean
): List<Short>
inline fun IntArray.filter(
predicate: (Int) -> Boolean
): List<Int>
inline fun LongArray.filter(
predicate: (Long) ...
الدالة Float.toShort() في Kotlin
تحوّل الدالة toShort() العدد العشري (float) الذي استُدعي معها إلى عدد من النوع Short (عدد قصير). هذا قد يؤدي إلى تدوير العدد المراد تحويله أو اقتطاع جزءٍ منه. البنية العامة fun toShort(): Short
حلت الدالة Number.toShort() مكان هذه الدالة. القيمة المعادة يعاد عددٌ من النوع Short يحوي العدد العشري المراد تحويله. أمثلة استعمال الدالة ()toShort لتحويل عدد من النوع Float إلى النوع Short: fun main(args: Array<String>) {
val x : Float = 52.7f
println(x.toShort() )// 52
}
انظر أيضًا الدالة toByte(): ...
الصنف FloatArray في Kotlin
يمثل الصنف FloatArray مصفوفةً من الأعداد العشرية. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []float. class FloatArray
الدوال البانية <init> تنشئ الدالة FloatArray() البانية مصفوفة جديدة من النوع FloatArray (أي مصفوفة من الأعداد العشرية) بحجم معين، وتحوي قيمًا محدَّدة أو القيم 0. الخاصيات size تمثِّل الخاصيّة FloatArray.size عدد العناصر الموجودة في المصفوفة ذات النوع FloatArray. الدوال get تجلب الدالة get() عنصرًا ذي فهرس محدد من المصفوفة. iterator ينشئ الدالة iterator() عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set تضبط الدالة set() قيمة عنصر ذي ...
الدالة windowed() في Kotlin
تعيد الدالة windowed() قائمة تحتوي على سلاسل نصية بحجم معين ثابت جلبت من سلسلة المحارف التي استدعيت معها عند التحرك بخطوات محددة ثابتة، أو تحوي ناتج تطبيق دالة معينة على تلك السلاسل النصية المجلوبة. البنية العامة fun CharSequence.windowed(
size: Int,
step: Int = 1,
partialWindows: Boolean = false
): List<String>
الإصدار المطلوب: Kotlin 1.2. تعيد الدالة windowed() قائمة مكونة من سلاسل نصية حجم كل منها يساوي size جلبت من سلسلة المحارف ...
الدالة Enum.hashCode() في Kotlin
تعيد الدالة hashCode() الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. تُحقِّق هذه الدالة الشرطين الآتيين دائمًا: تعيد نفس العدد الصحيح دائمًا في كل مرة تستدعى فيها مع الكائن نفسه شريطة عدم تغيُّر أيّ معلومة تستخدمها الدالة equals() عند موازنة هذا الكائن مع غيره. إذا تساوى كائنان بحسب الدالة equals()، فيجب أن تعيد الدالة hashCode() شيفرة hash نفسها لكلٍّ منها. البنية العامة open fun hashCode(): Int
وجود الكلمة المفتاحيّة open هنا يدل على السماح بإعادة تعريف (override) هذا التابع في الأصناف الفرعيّة ...
الدالة getOrElse() في Kotlin
تجلب الدالة getOrElse() عنصرًا ذا فهرس مُحدَّد من المصفوفة أو المجموعة التي استُدعيت معها أو القيمة المقابلة لمفتاح محدَّد إن استدعيت مع خريطة. إن كان الفهرس المعطى يقع خارج حدود المصفوفة أو المجموعة أو كان المفتاح المعطى غير موجود في الخريطة، فسيُعاد ناتج استدعاء دالة معيَّنة معطاة. البنية العامة يمكن استدعاء الدالة getOrElse() مع المصفوفات: inline fun <T> Array<out T>.getOrElse(
index: Int,
defaultValue: (Int) -> T
): T
inline fun ByteArray.getOrElse(
index: ...
الثابت Char.MAX_LOW_SURROGATE في Kotlin
يمثل الثابت Char.MAX_LOW_SURROGATE القيمة القصوى للبديل الأدنى لعدد بتات الترميز الموحد (Unicode low-surrogate code unit). البنية العامة const val MAX_LOW_SURROGATE: Char
انظر أيضًا الثابت Char.MAX_HIGH_SURROGATE: يمثّل القيمة القصوى للبديل الأعلى لوحدة اليونيكود (Unicode high-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: يمثل القيمة الدنيا لبديل ...
الدالة Appendable.append() في Kotlin
تضيف الدالة append() المحرف الممرر إليها أو كامل محتوى الكائن المُمرّر إليها أو جزءًا منه إلى الكائن المستدعى معها. البنية العامة abstract actual fun append(csq: CharSequence?): Appendable
abstract actual fun append(
csq: CharSequence?,
start: Int,
end: Int
): Appendable
abstract actual fun append(c: Char): Appendable
بيئة التشغيل المطلوبة: JS. المعاملات csq سلسلة من المحارف التي يراد إضافتها بأكملها أو جزء محدد منها إلى الكائن المعطى. start عدد صحيح يحدد فهرس المحرف الذي يمثل بداية ...
الدالة DoubleArray.iterator() في Kotlin
تنشئ الدالة iterator() عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. البنية العامة operator fun iterator(): DoubleIterator
وجود الكلمة المفتاحية operator يدل على أنّ هذه الدالة مرتبطٌ بمعامل تكرار (iteration operator، اطلع على المثال في الأسفل). القيم المعادة يعاد عنصرٌ تكراريٌٌ (iterator) من أجل تكرار بنيةٍ (block) برمجيةٍ معينة على كافّة عناصر المصفوفة المعطاة. أمثلة استعمال الدالة iterator() لتخصيص عنصر تكراري من أجل استخدامه في الحلقة for التكرارية التي تطبع قيم جميع العناصر: fun main(args: Array<String>) {
val f: (Int) -> ...
الصنف CharCategory في Kotlin
الدوال الموروثة clone يطلق التابع clone() استثناءً (exception) لأنّ ثوابت enum لا يمكن أن تُنسخ. هذا التابع يمنع الأصناف من النوع Enum من أن ترِث من الصنفCloneable. compareTo تقارن الدالةcompareTo() بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة 0 إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة . equals تبين الدالة equals() إذا ما كان الكائن المُمرّر إليها يساوي ...
الدالة trimMargin() في Kotlin
تحذف الدالة trimMargin() جميع المحارف البيضاء البادئة المتبوعة بقيمة محددة من جميع أسطر السلسلة النصية التي استُدعيت معها، كما تحذف السطر الأول والأخير إن كانا فارغين (blanks)؛ أي مُكوّنان من مسافات بيضاء (whitespaces). لا تؤثر الدالةُ على الاسطر التي لا تحوي القيمة المحددة بالمعامل marginPrefix المعطى، باستثناء الأسطر البيضاء الأولى والأخيرة. البنية العامة fun String.trimMargin(marginPrefix: String = "|"): String
المعاملات marginPrefix سلسلة نصية غير فارغة -أي لا تحوي أية مسافة بيضاة- تستعمل كمحدد للهامش المراد حذفه. القيمة الافتراضية هي: | ...
الدالة filterIsInstance() في Kotlin
تعيد الدالة filterIsInstance() قائمة تحوي عناصر المصفوفة أو المجموعة المعطاة التي هي نسخةٌ (instance) من نوع أو صنفٍ معيّن. البنية العامة inline fun <reified R> Array<*>.filterIsInstance(): List<R>
inline fun <reified R> Iterable<*>.filterIsInstance(): List<R>
يمكن تمرير المعامل klass إلى الدالة filterIsInstance(): fun <R> Array<*>.filterIsInstance(klass: Class<R>): List<R>
fun <R> Iterable<*>.filterIsInstance(klass: Class<R>): List<R>
بيئة التشغيل المطلوبة: JVM وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (لمزيد من التفاصيل، راجع توثيق الدوال المباشرة)، واستخدام الكلمة المفتاحية reified يسمح بالوصول إلى نوعٍ مُمرَّر كمتحولٍ وسيطٍ (parameter، راجع توثيق reified ...
الدالة replaceAfter() في Kotlin
تبدِّل الدالة replaceAfter() سلسلة نصية مكان كل الجزء الواقع بعد أول ظهور لمحرف أو لسلسلة نصية معينة في سلسلة نصية. البنية العامة fun String.replaceAfter(
delimiter: Char,
replacement: String,
missingDelimiterValue: String = this
): String
fun String.replaceAfter(
delimiter: String,
replacement: String,
missingDelimiterValue: String = this
): String
المعاملات delimiter المحرف أو السلسلة النصية التي يراد استبدال كامل الجزء الواقع بعدها. replacement ...
الدالة joinToString() في Kotlin
تضيف الدالة joinToString() بادئة ولاحقة إلى جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها (أو جزءٍ منها) بعد فصل عناصرها بفاصلة معينة ثمَّ تضع الناتج في سلسة نصية جديدة تنشئها آنذاك. إن كانت المجموعة كبيرة، فيمكن تحديد جزءٍ أولي معين منها فقط لإضافته إلى السلسلة النصية؛ في هذه الحالة، تضاف سلسلة نصية معيَّنة، مثل "..." أو "...إلخ" إلى السلسلة النصية الناتجة للدلالة على وجود جزءٍ مقتطعٍ. البنية العامة fun <T> Array<out T>.joinToString(
separator: CharSequence = ", ", ...
الدالة CharSequence.sumByDouble() في Kotlin
تجمع الدالة sumByDouble() جميع نواتج تطبيق دالة معيَّنة على كل محرف من محارف سلسلة المحارف التي استُدعيت معها. الفرق بين الدالة sumByDouble() والدالة sumBy() هو في نوع القيمة التي تستطيع الدالة الممرَّر إلى كلٍّ منهما إعادتها، إذ تعيد الدالة المُمرَّرة إلى sumBy() عددًّا صحيحًا (integer) بينما يمكن أن تعيد الدالة الممررة إلى sumByDouble() عددًا عشريًّا مضاعفًا (double). البنية العامة inline fun CharSequence.sumByDouble(
selector: (Char) -> Double
): Double
يُلاحَظ وجود الكلمة المفتاحية inline التي تدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). المعاملات selector الدالة التي ...
الدالة CharSequence.forEachIndexed() في Kotlin
تُنفّد الدالةُ forEachIndexed() الدالةَ المُمرّرةَ إليها على كل محرف من محارف السلسلة التي استُدعيت معها وعلى فهرس ذلك المحرف. البنية العامة inline fun CharSequence.forEachIndexed(
action: (index: Int, Char) -> Unit)
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات action الدالة المراد تنفيذها مع كل محرف من محارف السلسلة المعطاة. يمرر إليها فهرس المحرف index وقيمته Char. أمثلة مثالٌ على استعمال الدالة ()forEachIndexed: fun main(args: Array<String>) {
val str = "Hsoubwiki"
...
الدالة removeRange() في Kotlin
تحذف الدالة removeRange() مجالًا محددًا من سلسلة المحارف أو السلسلة النصية التي استٌدعيت معها. البنية العامة fun CharSequence.removeRange(
startIndex: Int,
endIndex: Int
): CharSequence
inline fun String.removeRange(
startIndex: Int,
endIndex: Int
): String
fun CharSequence.removeRange(range: IntRange): CharSequence
inline fun String.removeRange(range: IntRange): String
المعاملات startIndex عدد صحيح يشير إلى فهرس المحرف الذي يمثل بداية الجزء المراد حذفه. endIndex عدد صحيح يشير إلى فهرس المحرف الذي يمثل نهاية الجزء المراد حذفه (لا ...
الدالة text.isISOControl() في Kotlin
تتحقق الدالة isISOControl() إن كان المحرف الذي استٌدعي معها هو أحد محارف تحكمISO ISO control character)). البنية العامة inline fun Char.isISOControl(): Boolean
المنصة المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كان المحرف المعطى هو أحد محارف تحكمISO ، أو القيمة false خلاف ذلك. أمثلة استعمال الدالة isISOControl() لمعرفة أيُّ المحرفين التاليين هو من أحد محارف تحكم ISO: fun main(args: Array<String>) { ...
الدالة isNotEmpty() في Kotlin
تتحقق الدالة isNotEmpty() إن كانت سلسلة المحارف التي استٌدعيت معها غير فارغة. البنية العامة inline fun CharSequence.isNotEmpty(): Boolean
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كانت سلسلة المحارف المعطاة غير فارغة، أو القيمة false خلاف ذلك. أمثلة مثالٌ على استعمال الدالة isNotEmpty(): fun main(args: Array<String>) {
print("hsoub".isNotEmpty()) // true
print(" ".isNotEmpty()) // true
...
الخاصية MatchGroup.range في Kotlin
تمثل الخاصية MatchGroup.range مجال الفهارس التي تحدّد مكان مجموعة النتائج التي تم الحصول عليها. البنية العامة val range: IntRange
المنصة المطلوبة: JVM. القيم المعادة يعاد مجال الفهارس التي تحدّد مكان مجموعة النتائج التي تم الحصول عليها. انظر أيضًا الخاصية MatchGroup.value: تمثل قيمة مجموعة النتائج التي تم الحصول عليها. مصادر صفحة الخاصيّة MatchGroup.range في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.
الدالة map() في Kotlin
تعيد الدالة map() قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل عنصر من عناصر المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها. البنية العامة يمكن استدعاء الدالة map() مع المصفوفات والمجموعات والخرائط: inline fun <T, R> Array<out T>.map(
transform: (T) -> R
): List<R>
inline fun <R> ByteArray.map(transform: (Byte) -> R): List<R>
inline fun <R> ShortArray.map(
transform: (Short) -> R
): List<R>
inline fun <R> IntArray.map(transform: (Int) -> R): List<R>
inline fun <R> LongArray.map(transform: (Long) ...
الصنف CharDirectionality في Kotlin
الخاصيات الموروثة (Inherited Properties) name تعيد الخاصية name اسم الثابت من الكائن enum الذي استُدعيت عبره، كما سُمّيت أُثناء تعريف ذلك الكائن. ordinal تعيد الخاصية ordinal ترتيب الثابت من الكائن enum الذي استُدعيت عبره enumeration constant))، أي ترتيبها في تصريح الكائن enum،بحيث تأخذ المُركّبة الأولى العدد 0. الدوال الموروثة clone يطلق التابع clone() استثناءً (exception) لأنّ ثوابت enum لا يمكن أن تُنسخ. هذا التابع يمنع الأصناف من النوع Enum من أن ترِث من الصنفCloneable. compareTo تقارن الدالةcompareTo() بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة 0 إن كانا متساويين، أو تعيد قيمة سلبية ...
الدالة CharSequence.lastIndexOf() في Kotlin
تجلب الدالة lastIndexOf() فهرس آخر ظهور لمحرف أو سلسلة نصية محدَّدة من سلسلة المحارف التي استُدعيت معها. البنية العامة fun CharSequence.indexOf(
char: Char,
startIndex: Int = 0,
ignoreCase: Boolean = false
): Int
fun CharSequence.indexOf(
string: String,
startIndex: Int = 0,
ignoreCase: Boolean = false
): Int
المعاملات char المحرف المراد البحث عنه ضمن سلسلة من المحارف. startIndex السلسلة النصية المراد البحث عنها ضمن سلسلة ...
الدالة StringBuilder.reverse() في Kotlin
تعكس الدالة reverse() ترتيب محارف الكائن StringBuilder. البنية العامة actual fun reverse(): StringBuilder
منصة التشغيل المطلوبة: JS. القيمة المعادة يعاد الكائن StringBuilder نفسه المعطى بعد عكس ترتيب محارفه. أمثلة استعمال الدالة reverse() لعكس ترتيب محارف كائن من النوع StringBuilder: fun main(args: Array<String>) {
val sb = StringBuilder("hsoub")
println(sb.reverse()) // => buosh
}
انظر أيضًا الدالة append(): تضيف محرفًا أو سلسلة نصية أو أيَّ كائن آخر إلى الكائن StringBuilder. الدالة toString(): تحول الكائن StringBuilder إلى ...
الدالة drop() في Kotlin
تُزيِل الدالة drop() أول n محرف من محارف السلسلة النصية أو سلسلة المحارف التي استُدعيت معها. البنية العامة fun CharSequence.drop(n: Int): CharSequence
fun String.drop(n: Int): String
المعاملات n عدد صحيح يمثل عدد المحارف المراد حذفها من بداية السلسلة النصية. القيم المعادة تعاد سلسلة نصية أو سلسلة من المحارف تحوي جميع محارف السلسلة النصية أو سلسلة المحارف المعطاة باستثناء أول n محرف. أمثلة مثالٌ عن استعمال الدالة ()drop: fun main(args: Array<String>) {
val str = "wiki Hsoub"
println(str.drop(0)) // wiki Hsoub
...
الدالة also() في Kotlin
تستدعي الدالة also() بُنية (block) الدالة المُحدَّدة مع جعل قيمة this كوسيط (argument) وتُعيد قيمة this. البنية العامة inline fun <T> T.also(block: (T) -> Unit): T
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions)). المعاملات block الكتلة البرمجية المراد استدعاؤها وتنفيذها. القيم المعادة تعيد الكائن الذي استدعيت عبره بعد التعديل عليه. أمثلة استخدام الدالة also() مع الكائنات لتعديل خاصياتها (properties) تستدعي الشيفرة الآتية الدالة also() عبر السلسلة النصية string ...
الثابت Double.POSITIVE_INFINITY في Kotlin
يمثل الثابت Double.POSITIVE_INFINITY قيمة موجبة لا نهائية (infinity) لعدد عشري مضاعف (double). البنية العامة val POSITIVE_INFINITY: Double
أمثلة استخدام الثابت Double.POSITIVE_INFINITY لطباعة قيمة موجبة لا نهائية لعدد عشري مضاعف: fun main(args: Array<String>) {
println(Double.POSITIVE_INFINITY ) // Infinity
}
انظر أيضًا الثابت Double.MAX_VALUE: يمثل أكبر قيمة موجبة نهائية (finite) لعدد عشري مضاعف (double). الثابت Double.MIN_VALUE: يمثل أًصغر قيمة موجبة غير صفرية يمكن أن يأخذها عدد عشري مضاعف (double). الثابت Double.NEGATIVE_INFINITY: يمثل قيمة سالبة لا نهائية ...
الدالة plus() في Kotlin
تضيف الدالة plus() المحرف الذي استٌدعي معها إلى بداية السلسلة النصية المُمرّرة إليها. البنية العامة inline operator fun Char.plus(other: String): String
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). يدل أيضًا وجود الكلمة المفتاحيّة operator على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other السلسلة النصية الأخرى التي سيضاف إليها المحرف المعطى. القيم المعادة تعاد السلسلة النصية other بعد إضافة المحرف المعطى إلى بدايتها. أمثلة استعمال الدالة plus() لإضافة ...
الدالة Float.div() في Kotlin
تقسِّم الدالة div() العدد العشري (float) الذي استُدعي معها على العدد المُمرّر إليها ثمَّ تعيد الناتج. البنية العامة operator fun div(other: Byte): Float
operator fun div(other: Short): Float
operator fun div(other: Int): Float
operator fun div(other: Long): Float
operator fun div(other: Float): Float
operator fun div(other: Double): Double
وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other العدد الآخر الذي ستُجرَى عليه العملية. القيمة المعادة يعاد عدد عشري ناتج قسمة العدد العدد العشري المعطى على العدد other الممرّر. إن ...
الخاصية Char.directionality في Kotlin
تعيد الخاصية Char.directionality قيمة اتجاهية اليونيكود (Unicode directionality) للمحرف الذي استُدعيت معه. البنية العامة val Char.directionality: CharDirectionality
المنصة المطلوبة: JVM. القيم المعادة تعاد قيمة اتجاهية اليونيكود للمحرف المعطى. مثال استعمال الخاصية directionality لمعرفة اتجاهية عدة محارف: fun main(args: Array<String>) {
val x = 'a'
val y = 'أ'
val z = '4'
println(x.directionality) // LEFT_TO_RIGHT
println(y.directionality) // RIGHT_TO_LEFT_ARABIC
println(z.directionality) // EUROPEAN_NUMBER
}
انظر أيضًا ...
الدالة flatten() في Kotlin
تعيد الدالة flatten() قائمة واحدة تحوي جميع عناصر المصفوفات أو المجموعات المتشعبة ضمن المصفوفة أو المجموعة التي استُدعيت معها. البنية العامة يمكن استدعاء الدالة flatten() مع المصفوفات: fun <T> Array<out Array<out T>>.flatten(): List<T>
ويمكن استدعاؤها مع المجموعات: fun <T> Iterable<Iterable<T>>.flatten(): List<T>
القيم المعادة تُعاد قائمة واحدة تحوي جميع عناصر المصفوفات أو المجموعات المتشعبة ضمن المصفوفة أو المجموعة المعطاة. أمثلة استخدام الدالة ()flatten مع المصفوفات: fun main(args: Array<String>) {
val deepArray = arrayOf(
...
الدالة CharSequence.associateBy() في Kotlin
تعيد الدالة associateBy() خريطةً (map) مكونة من الأزواج "مفتاح/قيمة"، إذ يكون المفتاح (key) هو الناتج الذي تعيده الدالة keySelector الممررة إليها وتكون القيمة (value) المقابلة لذلك المفتاح هي إمَّا محارف سلسلة المحارف المعطاة أو الناتج الذي تعيده الدالة valueTransform الممررة. إن كان لزوجين نفس المفتاح (key)، فالأخير هو الذي سيُضاف إلى الخريطة. تحافظ الخريطة المُعادة على نفس ترتيب التكرار الخاص بسلسلة المحارف الأصليَّة. البنية العامة inline fun <K> CharSequence.associateBy(
keySelector: (Char) -> K
): Map<K, Char>
inline fun <K, V> CharSequence.associateBy(
...
الدالة CharSequence.lastOrNull() في Kotlin
تجلب الدالة lastOrNull() آخر محرف من محارف السلسلة التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو آخر عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها. إن كانت سلسلة المحارف التي استُدعيت الدالة lastOrNull() معها فارغةً أو لم يكن هناك أي عنصر يحقق الدالة المنطقية الممرَّرة إليها، فستعيد الدالة القيمة null. البنية العامة fun CharSequence.lastOrNull(): Char?
inline fun CharSequence.lastOrNull(
predicate: (Char) -> Boolean
): Char?
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات predicate دالةٌ تمثل الشرط المراد ...
الدالة CharSequence.foldIndexed() في Kotlin
تجمِّع الدالة foldIndexed() تراكميًّا ناتج تطبيق عملية معينة على فهرس كل محرف من محارف السلسلة المستدعاة معها (من اليسار إلى اليمين) وقيمته والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت. البنية العامة inline fun <R> CharSequence.foldIndexed(
initial: R,
operation: (index: Int, acc: R, Char) -> R
): R (source)
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات initial قيمة أولية يراد إضافتها مع ناتج تطبيق الدالة operation على أول ...
الخاصية indices في Kotlin
تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection). البنية العامة توفّر لغة Kotlin الخاصيّة indices للمصفوفات من الأنواع المختلفة كما يلي: val <T> Array<out T>.indices: IntRange
val ByteArray.indices: IntRange
val ShortArray.indices: IntRange
val IntArray.indices: IntRange
val LongArray.indices: IntRange
val FloatArray.indices: IntRange
val DoubleArray.indices: IntRange
val BooleanArray.indices: IntRange
val CharArray.indices: IntRange
وكذلك للمجموعة (collection) val Collection<*>.indices: IntRange
القيم المعادة الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection). أمثلة استخدام الخاصية indices مع المصفوفات: fun main(args: Array<String>) {
val array = arrayOf(4,5,7,9)
...
الدالة toMap() في Kotlin
تحول الدالة toMap() الكائن المستدعى معها إلى خريطة أو تضيف محتوى ذلك الكائن إلى خريطة موجودة مسبقًا. البنية العامة إن استدعيت الدالة toMap() مع مصفوفة أو مجموعة تكرارية أو سلسلة مكونة من أزواج، فستعيد خريطة تحوي كل تلك الأزواج؛ تحافظ الخريطة المُعادة على نفس ترتيب تكرار الخريطة الأصلية: fun <K, V> Iterable<Pair<K, V>>.toMap(): Map<K, V>
fun <K, V> Array<out Pair<K, V>>.toMap(): Map<K, V>
fun <K, V> Sequence<Pair<K, V>>.toMap(): Map<K, V>
وإن استدعيت الدالة toMap() مع مصفوفة أو مجموعة تكرارية أو سلسلة ...
الدالة Float.inc() في Kotlin
تزيد الدالة inc() العدد العشري (float) الذي استُدعي معها بمقدار 1 ثمَّ تعيد القيمة الناتجة. البنية العامة operator fun inc(): Float
وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). القيمة المعادة تعاد قيمة من النوع Float تمثل القيمة المعطاة بعد زيادتها بمقدار 1. أمثلة استعمال الدالة ()dec لزيادة عدد عشري بمقدار 1 فقط: fun main(args: Array<String>) {
val x: Float = 5.54f
println(x.inc()) // 6.54
}
انظر أيضًا ...
الدالة FloatArray.iterator() في Kotlin
ينشئ الدالة iterator() عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. البنية العامة operator fun iterator(): FloatIterator
وجود الكلمة المفتاحية operator يدل على أنّ هذه الدالة مرتبطٌ بمعامل تكرار (iteration operator، اطلع على المثال في الأسفل). القيم المعادة يعاد عنصرٌ تكراريٌٌ (iterator) من أجل تكرار بنيةٍ (block) برمجيةٍ معينة على كافّة عناصر المصفوفة المعطاة. أمثلة استعمال الدالة iterator() لتخصيص عنصر تكراري من أجل استخدامه في الحلقة for التكرارية التي تطبع قيم جميع العناصر: fun main(args: Array<String>) {
val f: (Int) -> ...
الدالة first() في Kotlin
تجلب الدالة first() أول عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها إن لم يمرر إليها أي شيء، أو أول عنصر يحق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها. إن كانت المصفوفة أو المجموعة التي استُدعيت الدالة first() عبرها فارغة أو لم يكن هناك أي عنصر يحقق الدالة المنطقية الممرَّرة إليها، فستُطلِق الدالة الاستثناء NoSuchElementException. البنية العامة يمكن استدعاء الدالة first() بدون تمرير أية معاملات: fun <T> Array<out T>.first(): T
fun ByteArray.first(): Byte
fun ShortArray.first(): Short
fun IntArray.first(): ...
الصنف DeprecationLevel في Kotlin
يحوي الصنف DeprecationLevel مستويات تصف درجات الإهمال (deprecation levels). enum class DeprecationLevel
القيم القابلة للعد (Enum Values) WARNING تشير القيمة WARNING إلى وجود تحذير تولد نتيجة استعمال عنصر مهمل (deprecated element). ERROR تشير القيمة ERROR إلى وجود خطأٍ تولد نتيجة استعمال عنصر مهمل (deprecated element). HIDDEN تشير القيمة HIDDEN إلى أن العنصر المهمل (deprecated elements) غير متاح للاستخدام ضمن الشيفرة. الخاصيات الموروثة (Inherited Properties) name تمثِّل الخاصية Enum.name اسم الثابت المعرف في الكائن enum الذي استُدعي معها كما سُمّي أُثناء تعريف هذا الكائن. ordinal تمثل الخاصية Enum.ordinal ترتيب (ordinal) الثابت المعرف في ...
الواجهة Appendable في Kotlin
actual typealias Appendable = Appendable
المنصة والإصدار المطلوبان: Kotlin 1.1، JVM. actual interface Appendable
المنصة المطلوبة: JS. الدوال append تضيف هذه الدالة المحرف الممرر إليها أو كامل محتوى الكائن المُمرّر إليها أو جزءًا منه إلى الكائن المستدعى معها. الدوال الموروثة equals تتحقق هذه الدالة إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعي معها. hashCode تعيد هذه الدالة الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. toString تحول هذه الدالة الكائن الذي يُستدعى معه إلى سلسلة نصية (String). مصادر صفحة الواجهة Appendable في التوثيق ...
الخاصية MatchResult.destructured في Kotlin
تمثل الخاصية MatchResult.destructured نسخةً من الصنف Destructured توفّر مكونات عملية الإسناد بالتفكيك (destructuring assignment) التي تطبق على قيم المجموعة المُطابقة. تطابق الدالة component1 قيمة المجموعة الأولى، وتطابق الدالة component2 قيمة المجموعة الثانية، وهلم جرًا. البنية العامة open val destructured: Destructured
القيمة المعادة تعاد نسخةٌ من الصنف Destructured. أمثلة ينشِئ التابع Regex() في الشيفرة التالية تعبيرًا نمطيًا باسم regex لتفكيك مسارات الملفات إلى ثلاث مُركّبات: المجلد (directory) واسم الملف (fileName) والامتداد (extension)، ثم نعرّف سلسلة نصية باسم fullPath تحتوي مسار أحد الملفات، ثم نستخرج من fullPath مجموعات النتائج عبر استدعاء الدالة ...
الدالة CharSequence.flatMap() في Kotlin
تعيد الدالة flatMap() قائمةً تضم ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف السلسلة التي استُدعيت معها. البنية العامة inline fun <R> CharSequence.flatMap(
transform: (Char) -> Iterable<R>
): List<R>
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات transform دالةٌ تطبق على كل محرف من محارف السلسلة المعطاة، وتعيد قيمة معينة تحل مكانه. القيم المعادة تُعاد قائمةٌ تضم ناتج تطبيق الدالة transform على كل محرف من محارف السلسلة المعطاة. أمثلة مثالٌ على استعمال الدالة ()flatMap: fun main(args: ...
عرض (100 السابقة | 100 التالية) (20 | 50 | 100 | 250 | 500).