الدالة fill()
في لغة Kotlin
< Kotlin | collections
تعيّن الدالةfill()
قيمة العناصر الموجودة في الفهارس المحددة للمصفوفة أو اللائحة التي استُدعيت عبرها وتعطيها القيمة الممررة إليها.
البنية العامة
يمكن استدعاء الدالةfill()
على المصفوفات.
fun <T> Array<T>.fill(
element: T,
fromIndex: Int = 0,
toIndex: Int = size)
fun ByteArray.fill(
element: Byte,
fromIndex: Int = 0,
toIndex: Int = size)
fun ShortArray.fill(
element: Short,
fromIndex: Int = 0,
toIndex: Int = size)
fun IntArray.fill(
element: Int,
fromIndex: Int = 0,
toIndex: Int = size)
fun LongArray.fill(
element: Long,
fromIndex: Int = 0,
toIndex: Int = size)
fun FloatArray.fill(
element: Float,
fromIndex: Int = 0,
toIndex: Int = size)
fun DoubleArray.fill(
element: Double,
fromIndex: Int = 0,
toIndex: Int = size)
fun BooleanArray.fill(
element: Boolean,
fromIndex: Int = 0,
toIndex: Int = size)
fun CharArray.fill(
element: Char,
fromIndex: Int = 0,
toIndex: Int = size)
يمكن استدعاء الدالةfill()
على اللوائح.
inline fun <T> MutableList<T>.fill(value: T)
يُلاحَظ وجود الكلمة المفتاحية inline
للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
أمثلة
استخدام الدالة ()fill
مع المصفوفات
تعرف الشيفرة الآتية مصفوفة باسم array
مكونة من ستة أعداد باستخدام الدالة ()arrayOf
، ثم تستخدم الدالة ()fill
لتعيين العناصر الموجودة عند الفهارس من 2
حتى 4
في المصفوفة وإعطائها القيمة 12
، ثم تطبع التمثيل النصي للمصفوفة باستخادم الدالة ()contentToString
ثم تطبع الناتج:
fun main(args: Array<String>) {
val array = arrayOf(1,2,3,4,5,6)
array.fill(12,2,4)
println(array.contentToString()) // [1, 2, 12, 12, 5, 6]
}
انظر أيضًا
elementAt()
: تعيد العنصر الموجود عند الفهرس (index) المحدد من المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود المصفوفة أو المجموعة فستُطلق استثناءً IndexOutOfBoundsException.