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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع text.toCharArray()‎ في لغة Kotlin}}</noinclude> تعيد الدالة <code>toCharArray()</code>‎ مصفوفة من ال...')
 
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: التابع text.toCharArray()‎ في لغة Kotlin}}</noinclude>
 
<noinclude>{{DISPLAYTITLE: التابع text.toCharArray()‎ في لغة Kotlin}}</noinclude>
−
تعيد الدالة <code>toCharArray()</code>‎ مصفوفة من النوع <code>[[Kotlin/ByteArray/index|ByteArray]]</code> تحتوي أكواد حروف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وفق الترميز المُمرّر <code>charset،</code> القيمة الابتدائية للوسيط <code>charset</code> هي <code>UTF_8</code>.
+
تعيد الدالة <code>toCharArray()</code>‎ مصفوفة من النوع <code>[[Kotlin/CharArray/index|CharArray]]</code> تحتوي حروف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها.
  
 
== البنية العامة ==
 
== البنية العامة ==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
−
inline fun String.toByteArray(
+
inline fun String.toCharArray(): CharArray
−
     charset: Charset = Charsets.UTF_8
+
 
−
): ByteArray
+
</syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM'''
 +
 
 +
تعيد الدالة <code>toCharArray()</code>‎ مصفوفة من النوع <code>[[Kotlin/CharArray/index|CharArray]]</code> تحتوي حروف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها.<syntaxhighlight lang="kotlin">
 +
inline fun String.toCharArray(
 +
    destination: CharArray,
 +
     destinationOffset: Int = 0,
 +
    startIndex: Int = 0,
 +
    endIndex: Int = length
 +
): CharArray
 
</syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM'''
 
</syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM'''
 +
 +
تنسخ الدالة <code>toCharArray()</code>‎  حروف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها في المصفوفة المُمرّرة <code>destination</code> ابتداء من الفهرس المحدد<code>destinationOffset</code> ثم تعيد تلك المصفوفة. الوسيطان <code>startIndex</code> و <code>endIndex</code> يحددان الجزء الذي سيُنسخ من  [[Kotlin/String|السلسلة النصية]] الأصلية.
  
 
يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 
يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 
== القيم المعادة ==
 
== القيم المعادة ==
−
مصفوفة من النوع <code>[[Kotlin/ByteArray/index|ByteArray]]</code>.
+
مصفوفة من النوع <code>[[Kotlin/CharArray/index|CharArray]]</code>.
  
 
== أمثلة ==
 
== أمثلة ==
سطر 17: سطر 27:
 
الشيفرة الآتية <nowiki/>تستدعي الدالة <code>toCharArray()‎</code> عبر عدة  [[Kotlin/String|سلاسل نصية]]، وتطبع الناتج:<syntaxhighlight lang="kotlin">
 
الشيفرة الآتية <nowiki/>تستدعي الدالة <code>toCharArray()‎</code> عبر عدة  [[Kotlin/String|سلاسل نصية]]، وتطبع الناتج:<syntaxhighlight lang="kotlin">
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
−
println("wiki.hsoub.com".toByteArray().toList()) // [119, 105, 107, 105, 46, 104, 115, 111, 117, 98, 46, 99, 111, 109]
+
println("wiki.hsoub.com".toCharArray().toList()) // [w, i, k, i, ., h, s, o, u, b, ., c, o, m]
−
println("3.14".toByteArray().toList()) // [51, 46, 49, 52]
+
println("3.14".toCharArray().toList()) // [3, ., 1, 4]
−
println("Aa".toByteArray(Charsets.UTF_16).toList()) // [-2, -1, 0, 65, 0, 97]
+
println("Aa".toCharArray().toList()) // [A, a]
−
 
+
}
 +
</syntaxhighlight>
 +
=== استخدام الدالة <code>toCharArray()‎</code> مع السلاسل النصية مع تمرير مصفوفة ===
 +
تعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code> ومصفوفة من النو ع <code>[[Kotlin/CharArray/index|CharArray]]</code> باسم <code>array</code>، ثم تستدعي الدالة <code>toCharArray()‎</code> عبر <code>str</code> وتمرر إليها  المصفوفة <code>array</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 +
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]
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
سطر 33: سطر 50:
  
 
== مصادر ==
 
== مصادر ==
−
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-byte-array.html صفحة الدالة text.toCharArray()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-char-array.html صفحة الدالة text.toCharArray()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Method]]
 
[[تصنيف:Kotlin Method]]

مراجعة 11:20، 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).
  • isDefined()‎: تعيد القيمة true في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).

مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=Kotlin/kotlin.text/toCharArray&oldid=12978"