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

المراجعة الحالية بتاريخ 10:23، 2 سبتمبر 2018

تعيد الدالة charset()‎ اسم الترميز للاسم الممرر إليها.

إن كان اسم الترميز المعطى غير صحيح أو غير مدعوم، فسيُطلَق الاستثناء UnsupportedCharsetException.

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

inline fun charset(charsetName: String): Charset

المعاملات

`charsetName`

سلسلة نصية تمثل اسم ترميز المحارف.

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

يعاد اسم الترميز المدعوم للاسم charsetName.

أمثلة

مثالٌ على استعمال الدالة ()charset:

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

انظر أيضًا

الصنف Charsets.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>text.charset()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>charset()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>charset()‎</code> نسخة من [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها، مع جعل الحرف الأول كبيرًا (uppercase).
+تعيد الدالة <code>charset()‎</code> اسم الترميز للاسم الممرر إليها.
+إن كان اسم الترميز المعطى غير صحيح أو غير مدعوم،  فسيُطلَق الاستثناء <code>UnsupportedCharsetException</code>.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-actual fun String.capitalize(): String
+inline fun charset(charsetName: String): Charset
 </syntaxhighlight>
+== المعاملات ==
+=== <code>charsetName</code> ===
+سلسلة نصية تمثل اسم ترميز المحارف.
 ==القيم المعادة==
-[[Kotlin/String|سلسلة نصية]].
+يعاد اسم الترميز المدعوم للاسم <code>charsetName</code>.
 ==أمثلة==
-===استخدام الدالة <code>()charset</code> مع سلسلة نصية===
+مثالٌ على استعمال الدالة <code>()charset</code><nowiki/>:<syntaxhighlight lang="kotlin">
-تعرِّف الشيفرة الآتية سلسلة نصية باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()charset</code> عبرها، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-     val str = "hsoub"
+     println(charset("utf8"))         // UTF-8
+     println(charset("Windows-1251")) // windows-1251
-     println(str.capitalize()) // Hsoub
 }
 </syntaxhighlight>
-===انظر أيضًا===
+==انظر أيضًا==
-* <code>[[Kotlin/kotlin.text/associateBy|associateBy()]]‎</code>: تعيد قاموسًا (map) يحتوي عناصر سلسلة الحروف التي استُدعيت عبرها مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>.
+* الصنف <code>[[Kotlin/kotlin.text/Charsets|Charsets]]</code>.
-* <code>[[Kotlin/kotlin.text/associateByTo|associateByTo()]]‎</code>: تعيد قاموسا متغيرا (mutable map) يحتوي أزواجًا من "مفتاح/قيمة"، إذ القيمة هي عناصر سلسلة الحروف التي استُدعيت عبرها، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>.
-* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
 ==مصادر==
-*[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 صفحة الدالة charset()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]