الدالة toCharArray()
في Kotlin
تضع الدالة toCharArray()
جميع محارف السلسلة النصية التي استٌدعيت معها في مصفوفة من النوع CharArray
، إذ يوضع كل محرف في عنصر.
البنية العامة
inline fun String.toCharArray(): CharArray
بيئة التشغيل المطلوبة: JVM.
تعيد الدالة toCharArray()
مصفوفة من النوع CharArray
تحتوي حروف السلسلة النصية التي استٌدعيت عبرها.
inline fun String.toCharArray(
destination: CharArray,
destinationOffset: Int = 0,
startIndex: Int = 0,
endIndex: Int = length
): CharArray
بيئة التشغيل المطلوبة: JVM.
تنسخ الدالة toCharArray()
محارف السلسلة النصية التي استٌدعيت معها إلى المصفوفة destination
ابتداءً من العنصر ذي الفهرس destinationOffset
ثم تعيد تلك المصفوفة. يحدد المعامل startIndex
والمعامل endIndex
الجزء الذي سيُنسَخ من السلسلة النصية.
يُلاحَظ وجود الكلمة المفتاحية inline
للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)).
المعاملات
destination
مصفوفة من النوع CharArray
موجودةً مسبقًا يراد أن يضاف فيها محتوى السلسلة النصية المعطاة.
destinationOffset
عدد صحيح يشير إلى فهرس العنصر الموجود في المصفوفة destination
والذي سيضاف محتوى السلسلة النصية المعطاة ابتداءًا منه.
startIndex
عدد صحيح يشير إلى فهرس المحرف الذي يمثل بداية المجال المراد نسخه من السلسلة النصية المعطاة وإضافته إلى المصفوفة destination
.
endIndex
عدد صحيح يشير إلى فهرس المحرف الذي يمثل نهاية المجال المراد نسخه من السلسلة النصية المعطاة وإضافته إلى المصفوفة destination
.
القيم المعادة
تعاد مصفوفة جديدة من النوع CharArray
أو المصفوفة destination
المعطاة بعض إضافة محتوى السلسلة النصية المعطاة فيها.
أمثلة
مثالٌ على استعمال الدالة toCharArray()
:
fun main(args: Array<String>) {
println("wikiHsoub".toCharArray().toList()) // [w, i, k, i, H, s, o, u, b]
println("3.14".toCharArray().toList()) // [3, ., 1, 4]
println("Aa".toCharArray().toList()) // [A, a]
}
مثالٌ آخر على استعمال الدالة toCharArray()
مع تمرير مصفوفة موجودة مسبقًا إليه:
fun main(args: Array<String>) {
val array = CharArray(10)
val str = "wikiHsoub"
println(str.toCharArray(array).toList()) // [w, i, k, i, H, s, o, u, b, ]
}
انظر أيضًا
toUpperCase()
: تحوّل الدالةtoUpperCase()
الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).toList()
: تعيد الدالةtoList()
لائحة تحتوي كل حروف سلسلة الحروف التي استٌدعيت عبرها.
toBigDecimalOrNull()
: تحلّل الدالةtoBigDecimalOrNull()
السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوعBigDecimal
.toBigDecimal()
: تحلّل الدالةtoBigDecimal()
السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوعBigDecimal
.
isDefined()
: تعيد القيمةtrue
في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).