الدالة toByteArray()‎ في Kotlin

من موسوعة حسوب
< Kotlin‏ | 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).

مصادر