الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/String»

مراجعة 11:55، 7 يوليو 2018

يختلف سلوك الدالة 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.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة text.String()‎ في لغة Kotlin}}</noinclude>
-يختلف سلوك الدالة <code>String()‎</code> بحسب نوع وعدد الوسائط المُمررة، انظر فقرة البنية العامة.
+يختلف سلوك الدالة <code>String()‎</code> بحسب نوع وعدد الوسائط المُمررة، انظر فقرة [[Kotlin/kotlin.text/String#.D8.A7.D9.84.D8.A8.D9.86.D9.8A.D8.A9 .D8.A7.D9.84.D8.B9.D8.A7.D9.85.D8.A9|البنية العامة]].
 == البنية العامة ==