الدالة text.String()‎ في لغة Kotlin

ينشِئ التابع String()‎ مصفوفةً من النوع ByteArray بحجم size مُحدَّدٍ، بحيث كل العناصر تساوي 0، وفي حال تمرير دالة كوسيط فسيُحسَب كلُّ عنصرٍ فيها عبر استدعاء الدالة init المُحدَّدة، والتي تُعيد عنصرًا في المصفوفة بحسب الفهرس (index) المُعطى.

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

inline fun String(
    bytes: ByteArray, 
    offset: Int, 
    length: Int, 
    charset: Charset
): String

بيئة التشغيل المطلوبة: JVM تحول الدالة String()‎ جزءًا من المصفوفة bytes (بداية من العنصر ذو الفهرس offset وبطولٍ يساوي length) باستخدام مجموعة الحروف (character set) المُمرّرة charset وتعيد ناتج التحويل على شكل سلسلة نصية.

inline fun String(bytes: ByteArray, charset: Charset): String

بيئة التشغيل المطلوبة: JVM تحول الدالة String()‎ المصفوفة bytesباستخدام مجموعة الحروف (character set) المُمرّرة charset وتعيد ناتج التحويل على شكل سلسلة نصية.

inline fun String(
    bytes: ByteArray, 
    offset: Int, 
    length: Int
): String

بيئة التشغيل المطلوبة: JVM تحول الدالة String()‎ جزءًا من المصفوفة bytes (بداية من العنصر ذو الفهرس offset وبطولٍ يساوي length) باستخدام مجموعة الحروف UTF-8 وتعيد ناتج التحويل على شكل سلسلة نصية.

inline fun String(bytes: ByteArray): String

بيئة التشغيل المطلوبة: JVM تحول الدالة String()‎ المصفوفة bytes باستخدام مجموعة الحروف UTF-8 وتعيد ناتج التحويل على شكل سلسلة نصية.

inline actual fun String(chars: CharArray): String

تحول الدالة String()‎ الحروف الموجودة في المصفوفة chars إلى سلسلة نصية.

inline actual fun String(
    chars: CharArray, 
    offset: Int, 
    length: Int
): String

تحول الدالة String()‎ الحروف الموجودة في المصفوفة chars (بداية من العنصر ذو الفهرس offset وبطولٍ يساوي length) إلى سلسلة نصية.

inline fun String(
    codePoints: IntArray, 
    offset: Int, 
    length: Int
): String

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

تحول الدالة String()‎ نقاط الأكواد (code points) الموجودة في المصفوفة codePoints (بداية من العنصر ذو الفهرس offset وبطولٍ يساوي length) من جزء إلى سلسلة نصية.

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

مصفوفة من النوع ByteArray بالحجم size.

أمثلة

استخدام التابع ByteArray()‎ لإنشاء المصفوفة

ينشِئ التابع ByteArray()‎ في الشيفرة الآتية مصفوفةً من ستة عناصر ، ثم تُطبَع عناصر المصفوفة:

import java.util.Arrays

fun main(args: Array<String>) {
val array = ByteArray(6)

print(Arrays.toString(array)) // [0, 0, 0, 0, 0, 0]
}

استخدام الدالة String()‎ لإنشاء المصفوفة مع تمرير دالة

ينشِئ التابع String()‎ في الشيفرة الآتية مصفوفةً بستة عناصر عبر تمرير الدالة المٌعرفة f،ثم تُطبَع عناصر المصفوفة:

import java.util.Arrays

fun main(args: Array<String>) {
val f: (Int) -> Byte = { x -> x.toByte() }
val array = ByteArray(6, f)

print(Arrays.toString(array)) // [0, 1, 2, 3, 4, 5]
}

انظر أيضًا

• صفحة الصنف ByteArray
• الخاصيّة ByteArray.size: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
• الأصناف والبواني (constructors) في لغة Kotlin.

مصادر

• الدالة text.String()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.