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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(مراجعة وتدقيق.)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع text.toByteArray()‎ في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: الدالة <code>toByteArray()‎</code> في Kotlin}}</noinclude>
تعيد الدالة <code>toByteArray()</code>‎ مصفوفة من النوع <code>[[Kotlin/ByteArray/index|ByteArray]]</code> تحتوي أكواد حروف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وفق الترميز المُمرّر <code>charset،</code> القيمة الابتدائية للوسيط <code>charset</code> هي <code>UTF_8</code>.
+
ترمز الدالة <code>toByteArray()</code>‎ جميع محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها وفقًا لترميز محدد ثم تضع الناتج في مصفوفة من النوع <code>[[Kotlin/ByteArray|ByteArray]]</code>.
  
 
== البنية العامة ==
 
== البنية العامة ==
سطر 7: سطر 7:
 
     charset: Charset = Charsets.UTF_8
 
     charset: Charset = Charsets.UTF_8
 
): ByteArray
 
): ByteArray
</syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM'''
+
</syntaxhighlight>'''بيئة التشغيل المطلوبة:''' JVM.
 +
 
 +
يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
 +
 
 +
== المعاملات ==
 +
 
 +
=== <code>charset</code> ===
 +
اسم الترميز المراد تحويل محارف السلسلة النصية المعطاة إليه. القيمة الافتراضية هي: <code>Charsets.UTF_8</code>.
  
يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 
 
== القيم المعادة ==
 
== القيم المعادة ==
مصفوفة من النوع <code>[[Kotlin/ByteArray/index|ByteArray]]</code>.
+
تعاد مصفوفة من النوع <code>[[Kotlin/ByteArray|ByteArray]]</code> تحوي ناتج ترميز جميع محارف [[Kotlin/String|السلسلة النصية]] المعطاة وفقًا للترميز <code>charset</code>.
  
 
== أمثلة ==
 
== أمثلة ==
=== استخدام الدالة <code>toByteArray()‎</code> مع السلاسل النصية ===
+
مث<nowiki/>الٌ على استعمال الدالة <code>toByteArray()‎</code>:<syntaxhighlight lang="kotlin">
الشيفرة الآتية <nowiki/>تستدعي الدالة <code>toByteArray()‎</code> عبر عدة  [[Kotlin/String|سلاسل نصية]]، وتطبع الناتج:<syntaxhighlight lang="kotlin">
 
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
println("wiki.hsoub.com".toByteArray().toList()) // [119, 105, 107, 105, 46, 104, 115, 111, 117, 98, 46, 99, 111, 109]
+
    println("wikiHsoub".toByteArray().toList()) // [119, 105, 107, 105, 72, 115, 111, 117, 98]
println("3.14".toByteArray().toList()) // [51, 46, 49, 52]
+
    println("3.14".toByteArray().toList()) // [51, 46, 49, 52]
println("Aa".toByteArray(Charsets.UTF_16).toList()) // [-2, -1, 0, 65, 0, 97]
+
    println("Aa".toByteArray(Charsets.UTF_16).toList()) // [-2, -1, 0, 65, 0, 97]
 
 
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
سطر 33: سطر 37:
  
 
== مصادر ==
 
== مصادر ==
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-byte-array.html صفحة الدالة text.toByteArray()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-byte-array.html صفحة الدالة toByteArray()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Method]]
+
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin Text]]

مراجعة 06:10، 6 سبتمبر 2018

ترمز الدالة toByteArray()‎ جميع محارف السلسلة النصية التي استٌدعيت معها وفقًا لترميز محدد ثم تضع الناتج في مصفوفة من النوع ByteArray.

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

inline fun String.toByteArray(
    charset: Charset = Charsets.UTF_8
): ByteArray

بيئة التشغيل المطلوبة: JVM.

يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)).

المعاملات

charset

اسم الترميز المراد تحويل محارف السلسلة النصية المعطاة إليه. القيمة الافتراضية هي: Charsets.UTF_8.

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

تعاد مصفوفة من النوع ByteArray تحوي ناتج ترميز جميع محارف السلسلة النصية المعطاة وفقًا للترميز charset.

أمثلة

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

fun main(args: Array<String>) {
    println("wikiHsoub".toByteArray().toList()) // [119, 105, 107, 105, 72, 115, 111, 117, 98]
    println("3.14".toByteArray().toList()) // [51, 46, 49, 52]
    println("Aa".toByteArray(Charsets.UTF_16).toList()) // [-2, -1, 0, 65, 0, 97]
}

انظر أيضًا

  • toUpperCase()‎ : تحوّل الدالة toUpperCase()‎ الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).
  • isDefined(): تعيد القيمة true في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).

مصادر