الفرق بين المراجعتين ل"Kotlin/kotlin.text/toCharArray"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(مراجعة وتدقيق.)
ط
 
سطر 51: سطر 51:
 
</syntaxhighlight>
 
</syntaxhighlight>
 
==انظر أيضًا==
 
==انظر أيضًا==
*<code>[[Kotlin/text/toUpperCase|toUpperCase()]]</code>‎ : تحوّل الدالة <code>toUpperCase()</code>‎ الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).
+
*الدالة [[Kotlin/kotlin.text/toByteArray|<code>toByteArray()</code>‎]]: ترمز جميع محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها وفقًا لترميز محدد ثم تضع الناتج في مصفوفة من النوع <code>[[Kotlin/ByteArray|ByteArray]]</code>.
*<code>[[Kotlin/kotlin.text/toList|toList()]]</code>‎ : تعيد الدالة <code>toList()</code>‎ [[Kotlin/List|لائحة]] تحتوي كل حروف [[Kotlin/CharSequence/index|سلسلة الحروف]]  التي استٌدعيت عبرها.
+
*الدالة <nowiki/>[[Kotlin/kotlin.text/toCollection|<code>toCollection()</code>‎]]: تضيف كل محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استٌدعيت معها إلى المجموعة المتغيرة المُمرّرة إليها.
 
+
*الدالة <nowiki/>[[Kotlin/kotlin.text/toHashSet|<code>toHashSet()</code>‎]]: تحلّل كائنًا من النوع <code>HashSet</code> يحوي كل محارف <nowiki/>[[Kotlin/CharSequence/index|السلسلة]] التي استٌدعيت معها.
*<code>[[Kotlin/text/isDefined|toBigDecimalOrNull()]]</code>: تحلّل الدالة <code>toBigDecimalOrNull()</code>‎ [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>BigDecimal</code>.
+
*الدالة <nowiki/>[[Kotlin/kotlin.text/toInt|<code>toInt()</code>‎]]: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح.
*<code>[[Kotlin/kotlin.text/toBigDecimal|toBigDecimal()]]</code>: تحلّل الدالة <code>toBigDecimal()</code>‎ [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>BigDecimal</code>.
+
*الدالة [[Kotlin/kotlin.text/toList|<code>toList()</code>‎]]: تضيف كل محارف [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها إلى [[Kotlin/collections/List|قائمة]]، إذ يوضع كل محرف في عنصر.
 
+
*الدالة <code>[[Kotlin/kotlin.text/toLong|toLong()]]</code>: تحلّل [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها وتحوّلها إلى [[Kotlin/Long|عدد طويل]].
*<code>[[Kotlin/text/isDefined|isDefined()]]</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
+
*الدالة [[Kotlin/text/toLowerCase|<code>toLowerCase()</code>‎]]: تحول [[Kotlin/Char|المحرف]] أو جميع محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها إلى محارف صغيرة (lowercase).
 +
*الدالة [[Kotlin/kotlin.text/toPattern|<code>toPattern()</code>‎]]: تحول [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها إلى نمط.
 +
*الدالة [[Kotlin/kotlin.text/toSet|<code>toSet()</code>‎]]: تضيف كل محارف [[Kotlin/CharSequence/index|سلسلة الحروف]]  التي استٌدعيت معها إلى مجموعة من النوع <code>[[Kotlin/Set|Set]]</code>، إذ يوضع كل محرف في عنصر.
 +
*الدالة [[Kotlin/kotlin.text/toShort|<code>toShort()</code>‎]]: تحلّل [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها وتحوّلها إلى [[Kotlin/Short|عدد قصير.]]
 +
*الدالة [[Kotlin/kotlin.text/toSortedSet|<code>toSortedSet()</code>‎]]: تضيف كل محارف [[Kotlin/CharSequence|السلسلة]]  التي استٌدعيت معها إلى مجموعة من النوع <code>[[Kotlin/collections/SortedSet|SortedSet]]</code>، إذ يوضع كل محرف في عنصر.
 +
*الدالة [[Kotlin/text/toTitleCase|<code>toTitleCase()</code>‎]]: تحول [[Kotlin/Char|المحرف]] الذي استٌدعي معها إلى محرف عنواني (titlecase). تتكون المحارف العنوانية عادةً من محرفين ملتصقين، مثل <code>'Dž'</code> أو <code>'Nj'</code>، إذ يعاملان وكأنَّهما محرفٌ واحدٌ فقط.
 
==مصادر==
 
==مصادر==
 
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-char-array.html صفحة الدالة toCharArray()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-char-array.html صفحة الدالة toCharArray()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]

المراجعة الحالية بتاريخ 11:35، 6 سبتمبر 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)).

المعاملات

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,  ]
}

انظر أيضًا

مصادر