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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(مراجعة وتدقيق.)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع text.toCharArray()‎ في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: الدالة <code>toCharArray()‎</code> في Kotlin}}</noinclude>
تعيد الدالة <code>toCharArray()</code>‎ مصفوفة من النوع <code>[[Kotlin/CharArray/index|CharArray]]</code> تحتوي حروف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها.
+
تضع الدالة <code>toCharArray()</code>‎ جميع محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها في مصفوفة من النوع <code>[[Kotlin/CharArray|CharArray]]</code>، إذ يوضع كل محرف في عنصر.
 
+
==البنية العامة==
== البنية العامة ==
 
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
 
inline fun String.toCharArray(): CharArray  
 
inline fun String.toCharArray(): CharArray  
  
</syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM'''
+
</syntaxhighlight>'''بيئة التشغيل المطلوبة:''' JVM.
  
تعيد الدالة <code>toCharArray()</code>‎ مصفوفة من النوع <code>[[Kotlin/CharArray/index|CharArray]]</code> تحتوي حروف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها.<syntaxhighlight lang="kotlin">
+
تعيد الدالة <code>toCharArray()</code>‎ مصفوفة من النوع <code>[[Kotlin/CharArray|CharArray]]</code> تحتوي حروف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها.<syntaxhighlight lang="kotlin">
 
inline fun String.toCharArray(
 
inline fun String.toCharArray(
 
     destination: CharArray,  
 
     destination: CharArray,  
سطر 15: سطر 14:
 
     endIndex: Int = length
 
     endIndex: Int = length
 
): CharArray
 
): 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>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> للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
== القيم المعادة ==
 
مصفوفة من النوع <code>[[Kotlin/CharArray/index|CharArray]]</code>.
 
  
== أمثلة ==
+
== المعاملات ==
=== استخدام الدالة <code>toCharArray()‎</code> مع السلاسل النصية ===
+
 
الشيفرة الآتية <nowiki/>تستدعي الدالة <code>toCharArray()‎</code> عبر عدة  [[Kotlin/String|سلاسل نصية]]، وتطبع الناتج:<syntaxhighlight lang="kotlin">
+
=== <code>destination</code> ===
 +
مصفوفة من النوع <code>[[Kotlin/CharArray|CharArray]]</code> موجودةً مسبقًا يراد أن يضاف فيها محتوى السلسلة النصية المعطاة.
 +
 
 +
=== <code>destinationOffset</code> ===
 +
عدد صحيح يشير إلى فهرس العنصر الموجود في المصفوفة <code>destination</code> والذي سيضاف محتوى السلسلة النصية المعطاة ابتداءًا منه.
 +
 
 +
=== <code>startIndex</code> ===
 +
عدد صحيح يشير إلى فهرس المحرف الذي يمثل بداية المجال المراد نسخه من السلسلة النصية المعطاة وإضافته إلى المصفوفة <code>destination</code>.
 +
 
 +
=== <code>endIndex</code> ===
 +
عدد صحيح يشير إلى فهرس المحرف الذي يمثل نهاية المجال المراد نسخه من السلسلة النصية المعطاة وإضافته إلى المصفوفة <code>destination</code>.
 +
 
 +
==القيم المعادة==
 +
تعاد مصفوفة جديدة من النوع <code>[[Kotlin/CharArray/index|CharArray]]</code> أو المصفوفة <code>destination</code> المعطاة بعض إضافة محتوى السلسلة النصية المعطاة فيها.
 +
==أمثلة==
 +
مثالٌ على استعمال الدالة <code>toCharArray()‎</code>:<syntaxhighlight lang="kotlin">
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
println("wiki.hsoub.com".toCharArray().toList()) // [w, i, k, i, ., h, s, o, u, b, ., c, o, m]
+
    println("wikiHsoub".toCharArray().toList()) // [w, i, k, i, H, s, o, u, b]
println("3.14".toCharArray().toList()) // [3, ., 1, 4]
+
    println("3.14".toCharArray().toList()) // [3, ., 1, 4]
println("Aa".toCharArray().toList()) // [A, a]
+
    println("Aa".toCharArray().toList()) // [A, a]
 
}
 
}
</syntaxhighlight>
+
</syntaxhighlight>مثالٌ آخر على استعمال الدالة <code>toCharArray()‎</code> مع تمرير مصفوفة موجودة مسبقًا إليه:<syntaxhighlight lang="kotlin">
=== استخدام الدالة <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>) {
 
fun main(args: Array<String>) {
val array = CharArray(14)
+
    val array = CharArray(10)
val str = "wiki.hsoub.com"  
+
    val str = "wikiHsoub"
println(str.toCharArray(array).toList()) // [w, i, k, i, ., h, s, o, u, b, ., c, o, m]
+
    println(str.toCharArray(array).toList()) // [w, i, k, i, H, s, o, u, b, ]
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
 
+
==انظر أيضًا==
== انظر أيضًا ==
+
*<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/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>.
 
*<code>[[Kotlin/kotlin.text/toBigDecimal|toBigDecimal()]]‎</code>: تحلّل الدالة <code>toBigDecimal()</code>‎ [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>BigDecimal</code>.
 
*<code>[[Kotlin/kotlin.text/toBigDecimal|toBigDecimal()]]‎</code>: تحلّل الدالة <code>toBigDecimal()</code>‎ [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>BigDecimal</code>.
  
* <code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
+
*<code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
 
+
==مصادر==
== مصادر ==
+
*[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 صفحة الدالة text.toCharArray()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Method]]
+
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin Text]]

مراجعة 07:15، 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,  ]
}

انظر أيضًا

  • toUpperCase()‎ : تحوّل الدالة toUpperCase()‎ الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).
  • toList()‎ : تعيد الدالة toList()لائحة تحتوي كل حروف سلسلة الحروف  التي استٌدعيت عبرها.
  • isDefined(): تعيد القيمة true في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).

مصادر