الفرق بين المراجعتين ل"Kotlin/kotlin.text/String"
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة text.String() في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة text.String() في لغة Kotlin}}</noinclude> | ||
− | + | يختلف سلوك الدالة <code>String()</code> بحسب نوع وعدد الوسائط المُمررة، انظر فقرة البنية العامة. | |
== البنية العامة == | == البنية العامة == | ||
سطر 48: | سطر 48: | ||
</syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM''' | </syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM''' | ||
− | تحول الدالة <code>String()</code> نقاط الأكواد (code points) الموجودة في المصفوفة <code>codePoints</code> (بداية من العنصر ذو الفهرس <code>offset</code> وبطولٍ يساوي <code>length</code>) | + | تحول الدالة <code>String()</code> نقاط الأكواد (code points) الموجودة في المصفوفة <code>codePoints</code> (بداية من العنصر ذو الفهرس <code>offset</code> وبطولٍ يساوي <code>length</code>) إلى [[Kotlin/String|سلسلة نصية]].<syntaxhighlight lang="kotlin"> |
+ | inline fun String(stringBuffer: StringBuffer): String | ||
− | + | </syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM''' | |
− | + | ||
+ | تحول الدالة <code>String()</code> محتويات الكائن المُمرّر <code>stringBuffer</code> إلى [[Kotlin/String|سلسلة نصية]].<syntaxhighlight lang="kotlin"> | ||
+ | inline fun String(stringBuilder: StringBuilder): String | ||
− | + | </syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM''' | |
− | + | تحول الدالة <code>String()</code> محتويات الكائن المُمرّر <code>stringBuilder</code> إلى [[Kotlin/String|سلسلة نصية]]. | |
− | |||
− | |||
− | + | == القيم المعادة == | |
− | + | [[Kotlin/String|سلسلة نصية]]. | |
− | + | == أمثلة == | |
− | |||
− | |||
− | === | ||
− | |||
− | |||
+ | === استخدام الدالة<code>String()</code> === | ||
+ | ينشِئ التابع <code>ByteArray()</code> في الشيفرة الآتية مصفوفةً باسم <code>array</code> مكونة من عشرة عناصر ، ثم نمرر <code>array</code> إلى الدالة <code>String()</code> لتحويل جزء منها إلى [[Kotlin/String|سلسلة نصية]]، ثم نطبَع الناتج:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
− | val f: (Int) -> Byte = { x -> x.toByte() } | + | val f: (Int) -> Byte = { x -> (x+97).toByte() } |
− | val array = ByteArray( | + | val array = ByteArray(10, f) |
+ | |||
+ | val x = String(array, 2, 6) | ||
− | print( | + | print(x) // cdefgh |
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* صفحة الصنف <code>[[Kotlin/ByteArray/index|ByteArray]]</code> | * صفحة الصنف <code>[[Kotlin/ByteArray/index|ByteArray]]</code> | ||
− | * | + | |
− | * [[Kotlin/ | + | * <code>[[Kotlin/text/isDefined|isDefined()]]</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode). |
+ | |||
+ | * الخاصية <code>[[Kotlin/kotlin.text/indices|indices]]</code>: تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) لسلسلة الحروف التي استُدعيت عبرها. | ||
== مصادر == | == مصادر == | ||
− | * [ | + | * [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-string.html الدالة text.String() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Method]] | [[تصنيف:Kotlin Method]] |
مراجعة 11:53، 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) لسلسلة الحروف التي استُدعيت عبرها.