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

من موسوعة حسوب
ط استبدال النص - 'Kotlin Functions' ب'Kotlin Function'
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>text.charset()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>text.charset()‎</code> في لغة Kotlin}}</noinclude>
تعيد الدالة <code>charset()‎</code> مجموعة المحارف المُسمّاة (named charset) ذات الاسم المُمرّر <code>charsetName.</code>  
تعيد الدالة <code>charset()‎</code> اسم الترميز للاسم الممرر إليها.   


في حال كانت مجموعة المحارف المُسمّاة غير متاحة فسيطلق Kotlin استثناءً <code>UnsupportedCharsetException</code> .  
إن كان اسم الترميز المعطى غير صحيح أو غير مدعوم، فسيُطلَق الاستثناء <code>UnsupportedCharsetException</code> .  
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
سطر 8: سطر 8:


</syntaxhighlight>
</syntaxhighlight>
== المعاملات ==
=== <code>charsetName</code> ===
سلسلة نصية تمثل اسم ترميز المحارف.
==القيم المعادة==
==القيم المعادة==
مجموعة محارف (<code>charset</code>).  
يعاد اسم الترميز المدعوم للاسم <code>charsetName</code>.  
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()charset</code>===
مثالٌ على استعمال الدالة <code>()charset</code><nowiki/>:<syntaxhighlight lang="kotlin">
تستدعي الشيفرة الآتية الدالة  <code>()charset</code> مع تمرير  <code>"Windows-1251"</code> كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
     println(charset("Windows-1251")) // windows-1251  
    println(charset("utf8"))        // UTF-8
     println(charset("Windows-1251")) // windows-1251
}
}
</syntaxhighlight>
</syntaxhighlight>
===انظر أيضًا===
==انظر أيضًا==
* <code>[[Kotlin/kotlin.text/associateBy|associateBy()]]‎</code>: تعيد قاموسًا (map) يحتوي عناصر سلسلة الحروف التي استُدعيت عبرها مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>.
* <code>[[Kotlin/kotlin.text/associateBy|associateBy()]]‎</code>: تعيد قاموسًا (map) يحتوي عناصر سلسلة الحروف التي استُدعيت عبرها مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>.


سطر 24: سطر 30:


==مصادر==
==مصادر==
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/charset.html الدالة text.charset()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/charset.html الدالة charset()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Function]]

مراجعة 09:16، 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
}

انظر أيضًا

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

مصادر