الفرق بين المراجعتين ل"Kotlin/kotlin.text/toCharArray"
جميل-بيلوني (نقاش | مساهمات) ط |
|||
(مراجعة متوسطة واحدة بواسطة نفس المستخدم غير معروضة) | |||
سطر 1: | سطر 1: | ||
− | <noinclude>{{DISPLAYTITLE: | + | <noinclude>{{DISPLAYTITLE: الدالة <code>toCharArray()</code> في Kotlin}}</noinclude> |
− | + | تضع الدالة <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>'''بيئة التشغيل المطلوبة: | + | </syntaxhighlight>'''بيئة التشغيل المطلوبة:''' JVM. |
− | تعيد الدالة <code>toCharArray()</code> مصفوفة من النوع <code>[[Kotlin/CharArray | + | تعيد الدالة <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>'''بيئة التشغيل المطلوبة: | + | </syntaxhighlight>'''بيئة التشغيل المطلوبة:''' JVM. |
+ | |||
+ | تنسخ الدالة <code>toCharArray()</code> محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها إلى المصفوفة <code>destination</code> ابتداءً من العنصر ذي الفهرس <code>destinationOffset</code> ثم تعيد تلك المصفوفة. يحدد المعامل <code>startIndex</code> والمعامل <code>endIndex</code> الجزء الذي سيُنسَخ من [[Kotlin/String|السلسلة النصية]]. | ||
+ | |||
+ | يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]). | ||
+ | |||
+ | == المعاملات == | ||
− | + | === <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(" | + | 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"> |
− | |||
− | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
− | val array = CharArray( | + | val array = CharArray(10) |
− | val str = " | + | val str = "wikiHsoub" |
− | println(str.toCharArray(array).toList()) // [w, i, k, i, | + | println(str.toCharArray(array).toList()) // [w, i, k, i, H, s, o, u, b, ] |
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | + | ==انظر أيضًا== | |
− | == انظر أيضًا == | + | *الدالة [[Kotlin/kotlin.text/toByteArray|<code>toByteArray()</code>]]: ترمز جميع محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها وفقًا لترميز محدد ثم تضع الناتج في مصفوفة من النوع <code>[[Kotlin/ByteArray|ByteArray]]</code>. |
− | * <code>[[Kotlin/text/ | + | *الدالة <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|السلسلة]] التي استٌدعيت معها. |
− | + | *الدالة <nowiki/>[[Kotlin/kotlin.text/toInt|<code>toInt()</code>]]: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح. | |
− | *<code>[[Kotlin/text/ | + | *الدالة [[Kotlin/kotlin.text/toList|<code>toList()</code>]]: تضيف كل محارف [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها إلى [[Kotlin/collections/List|قائمة]]، إذ يوضع كل محرف في عنصر. |
− | * | + | *الدالة <code>[[Kotlin/kotlin.text/toLong|toLong()]]</code>: تحلّل [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها وتحوّلها إلى [[Kotlin/Long|عدد طويل]]. |
− | + | *الدالة [[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|عدد قصير.]] |
− | * [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-char-array.html صفحة الدالة | + | *الدالة [[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.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
− | [[تصنيف:Kotlin | + | [[تصنيف:Kotlin Function]] |
+ | [[تصنيف:Kotlin Text]] |
المراجعة الحالية بتاريخ 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, ]
}
انظر أيضًا
- الدالة
toByteArray()
: ترمز جميع محارف السلسلة النصية التي استٌدعيت معها وفقًا لترميز محدد ثم تضع الناتج في مصفوفة من النوعByteArray
. - الدالة
toCollection()
: تضيف كل محارف السلسلة التي استٌدعيت معها إلى المجموعة المتغيرة المُمرّرة إليها. - الدالة
toHashSet()
: تحلّل كائنًا من النوعHashSet
يحوي كل محارف السلسلة التي استٌدعيت معها. - الدالة
toInt()
: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح. - الدالة
toList()
: تضيف كل محارف سلسلة المحارف التي استٌدعيت معها إلى قائمة، إذ يوضع كل محرف في عنصر. - الدالة
toLong()
: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد طويل. - الدالة
toLowerCase()
: تحول المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف صغيرة (lowercase). - الدالة
toPattern()
: تحول السلسلة النصية التي استٌدعيت معها إلى نمط. - الدالة
toSet()
: تضيف كل محارف سلسلة الحروف التي استٌدعيت معها إلى مجموعة من النوعSet
، إذ يوضع كل محرف في عنصر. - الدالة
toShort()
: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد قصير. - الدالة
toSortedSet()
: تضيف كل محارف السلسلة التي استٌدعيت معها إلى مجموعة من النوعSortedSet
، إذ يوضع كل محرف في عنصر. - الدالة
toTitleCase()
: تحول المحرف الذي استٌدعي معها إلى محرف عنواني (titlecase). تتكون المحارف العنوانية عادةً من محرفين ملتصقين، مثل'Dž'
أو'Nj'
، إذ يعاملان وكأنَّهما محرفٌ واحدٌ فقط.