الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/charset»

مراجعة 19:22، 7 يوليو 2018

تعيد الدالة charset()‎ مجموعة المحارف المُسمّاة (named charset) ذات الاسم المُمرّر charsetName.

في حال كانت مجموعة المحارف المُسمّاة غير متاحة فسيطلق Kotlin استثناءً UnsupportedCharsetException .

البنية العامة

inline fun charset(charsetName: String): Charset

القيم المعادة

مجموعة محارف (charset).

أمثلة

استخدام الدالة `()charset`

تستدعي الشيفرة الآتية الدالة ()charset مع تمرير "Windows-1251" كوسيط، ثمَّ تطبع الناتج:

fun main(args: Array<String>) {
    println(charset("Windows-1251")) // windows-1251 
}

انظر أيضًا

associateBy()‎: تعيد قاموسًا (map) يحتوي عناصر سلسلة الحروف التي استُدعيت عبرها مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالة keySelector.

associateByTo()‎: تعيد قاموسا متغيرا (mutable map) يحتوي أزواجًا من "مفتاح/قيمة"، إذ القيمة هي عناصر سلسلة الحروف التي استُدعيت عبرها، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة keySelector.
asSequence()‎: تنشئ كائنًا من الصنف Sequence والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.

مصادر

الدالة text.charset()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>text.charset()‎</code> في لغة Kotlin}}</noinclude>
-تعيد الدالة <code>charset()‎</code> نسخة من [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها، مع جعل الحرف الأول كبيرًا (uppercase).
+تعيد الدالة <code>charset()‎</code> مجموعة المحارف المُسمّاة (named charset) ذات الاسم المُمرّر <code>charsetName.</code>
+في حال كانت مجموعة المحارف المُسمّاة غير متاحة فسيطلق Kotlin  استثناءً <code>UnsupportedCharsetException</code> .
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-actual fun String.capitalize(): String
+inline fun charset(charsetName: String): Charset
 </syntaxhighlight>
 ==القيم المعادة==
-[[Kotlin/String|سلسلة نصية]].
+مجموعة محارف (<code>charset</code>).
 ==أمثلة==
-===استخدام الدالة <code>()charset</code> مع سلسلة نصية===
+===استخدام الدالة <code>()charset</code>===
-تعرِّف الشيفرة الآتية سلسلة نصية باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()charset</code> عبرها، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
+تستدعي الشيفرة الآتية الدالة  <code>()charset</code> مع تمرير  <code>"Windows-1251"</code> كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-    val str = "hsoub"
+     println(charset("Windows-1251")) // windows-1251
-     println(str.capitalize()) // Hsoub
 }
 </syntaxhighlight>
@@ سطر 24: / سطر 24: @@
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/capitalize.html الدالة text.charset()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/charset.html الدالة text.charset()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]