الفرق بين المراجعتين ل"Kotlin/kotlin.text/toCharArray"
| سطر 43: | سطر 43: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* <code>[[Kotlin/text/toUpperCase|toUpperCase()]]</code> : تحوّل الدالة <code>toUpperCase()</code> الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase). | * <code>[[Kotlin/text/toUpperCase|toUpperCase()]]</code> : تحوّل الدالة <code>toUpperCase()</code> الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase). | ||
| + | * <code>[[Kotlin/kotlin.text/toList|toList()]]</code> : تعيد الدالة <code>toList()</code> [[Kotlin/List|لائحة]] تحتوي كل حروف [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها. | ||
*<code>[[Kotlin/text/isDefined|toBigDecimalOrNull()]]</code>: تحلّل الدالة <code>toBigDecimalOrNull()</code> [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>BigDecimal</code>. | *<code>[[Kotlin/text/isDefined|toBigDecimalOrNull()]]</code>: تحلّل الدالة <code>toBigDecimalOrNull()</code> [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>BigDecimal</code>. | ||
مراجعة 18:38، 13 يوليو 2018
تعيد الدالة 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).
القيم المعادة
مصفوفة من النوع CharArray.
أمثلة
استخدام الدالة toCharArray() مع السلاسل النصية
الشيفرة الآتية تستدعي الدالة toCharArray() عبر عدة سلاسل نصية، وتطبع الناتج:
fun main(args: Array<String>) {
println("wiki.hsoub.com".toCharArray().toList()) // [w, i, k, i, ., h, s, o, u, b, ., c, o, m]
println("3.14".toCharArray().toList()) // [3, ., 1, 4]
println("Aa".toCharArray().toList()) // [A, a]
}
استخدام الدالة toCharArray() مع السلاسل النصية مع تمرير مصفوفة
تعرّف الشيفرة الآتية سلسلة نصية باسم str ومصفوفة من النو ع CharArray باسم array، ثم تستدعي الدالة toCharArray() عبر str وتمرر إليها المصفوفة array، ثم تطبع الناتج:
fun main(args: Array<String>) {
val array = CharArray(14)
val str = "wiki.hsoub.com"
println(str.toCharArray(array).toList()) // [w, i, k, i, ., h, s, o, u, b, ., c, o, m]
}
انظر أيضًا
toUpperCase() : تحوّل الدالةtoUpperCase() الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).toList() : تعيد الدالةtoList() لائحة تحتوي كل حروف سلسلة الحروف التي استٌدعيت عبرها.
toBigDecimalOrNull(): تحلّل الدالةtoBigDecimalOrNull() السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوعBigDecimal.toBigDecimal(): تحلّل الدالةtoBigDecimal() السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوعBigDecimal.
isDefined(): تعيد القيمةtrueفي حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).