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

يختلف سلوك الدالة String()‎ بحسب نوع وعدد الوسائط المُمررة، انظر فقرة البنية العامة.

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

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) إلى سلسلة نصية.

inline fun String(stringBuffer: StringBuffer): String

بيئة التشغيل المطلوبة: JVM تحول الدالة String()‎ محتويات الكائن المُمرّر stringBuffer إلى سلسلة نصية.

inline fun String(stringBuilder: StringBuilder): String

بيئة التشغيل المطلوبة: JVM تحول الدالة String()‎ محتويات الكائن المُمرّر stringBuilder إلى سلسلة نصية.

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

سلسلة نصية.

أمثلة

استخدام الدالةString()‎

ينشِئ التابع ByteArray()‎ في الشيفرة الآتية مصفوفةً باسم array مكونة من عشرة عناصر ، ثم نمرر array إلى الدالة String()‎ لتحويل جزء منها إلى سلسلة نصية، ثم نطبَع الناتج:

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

print(x) // cdefgh
}

انظر أيضًا

• صفحة الصنف ByteArray

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

• الخاصية indices: تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) لسلسلة الحروف التي استُدعيت عبرها.

مصادر

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