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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط (استبدال النص - 'Kotlin Functions' ب'Kotlin Function')
(مراجعة وتدقيق.)
 
(مراجعة متوسطة واحدة بواسطة نفس المستخدم غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>text.charset()‎</code> في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: الدالة <code>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/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/charset.html الدالة text.charset()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/charset.html صفحة الدالة charset()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Function]]
 
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin Text]]

المراجعة الحالية بتاريخ 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
}

انظر أيضًا

مصادر