الفرق بين المراجعتين ل"Kotlin/kotlin.text/String"
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة text.String() في لغة Kotlin}}</noinclude> ينشِئ التابع <code>String()</code> مصفوفةً من النوع...') |
|||
سطر 4: | سطر 4: | ||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
− | ByteArray | + | inline fun String( |
− | + | bytes: ByteArray, | |
+ | offset: Int, | ||
+ | length: Int, | ||
+ | charset: Charset | ||
+ | ): String | ||
+ | </syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM''' | ||
− | </syntaxhighlight> | + | تحول الدالة <code>String()</code> جزءًا من المصفوفة <code>bytes</code> (بداية من العنصر ذو الفهرس <code>offset</code> وبطولٍ يساوي <code>length</code>) باستخدام مجموعة الحروف (character set) المُمرّرة <code>charset</code> وتعيد ناتج التحويل على شكل [[Kotlin/String|سلسلة نصية]].<syntaxhighlight lang="kotlin"> |
+ | inline fun String(bytes: ByteArray, charset: Charset): String | ||
+ | |||
+ | </syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM''' | ||
+ | |||
+ | تحول الدالة <code>String()</code> المصفوفة <code>bytes</code>باستخدام مجموعة الحروف (character set) المُمرّرة <code>charset</code> وتعيد ناتج التحويل على شكل [[Kotlin/String|سلسلة نصية]].<syntaxhighlight lang="kotlin"> | ||
+ | inline fun String( | ||
+ | bytes: ByteArray, | ||
+ | offset: Int, | ||
+ | length: Int | ||
+ | ): String | ||
+ | </syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM''' | ||
+ | |||
+ | تحول الدالة <code>String()</code> جزءًا من المصفوفة <code>bytes</code> (بداية من العنصر ذو الفهرس <code>offset</code> وبطولٍ يساوي <code>length</code>) باستخدام مجموعة الحروف UTF-8 وتعيد ناتج التحويل على شكل [[Kotlin/String|سلسلة نصية]].<syntaxhighlight lang="kotlin"> | ||
+ | inline fun String(bytes: ByteArray): String | ||
+ | |||
+ | </syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM''' | ||
+ | |||
+ | تحول الدالة <code>String()</code> المصفوفة <code>bytes</code> باستخدام مجموعة الحروف UTF-8 وتعيد ناتج التحويل على شكل [[Kotlin/String|سلسلة نصية]].<syntaxhighlight lang="kotlin"> | ||
+ | inline actual fun String(chars: CharArray): String | ||
+ | |||
+ | |||
+ | </syntaxhighlight>تحول الدالة <code>String()</code> الحروف الموجودة في المصفوفة <code>chars</code> إلى [[Kotlin/String|سلسلة نصية]].<syntaxhighlight lang="kotlin"> | ||
+ | inline actual fun String( | ||
+ | chars: CharArray, | ||
+ | offset: Int, | ||
+ | length: Int | ||
+ | ): String | ||
+ | </syntaxhighlight>تحول الدالة <code>String()</code> الحروف الموجودة في المصفوفة <code>chars</code> (بداية من العنصر ذو الفهرس <code>offset</code> وبطولٍ يساوي <code>length</code>) إلى [[Kotlin/String|سلسلة نصية]].<syntaxhighlight lang="kotlin"> | ||
+ | inline fun String( | ||
+ | codePoints: IntArray, | ||
+ | offset: Int, | ||
+ | length: Int | ||
+ | ): String | ||
+ | </syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM''' | ||
+ | |||
+ | تحول الدالة <code>String()</code> نقاط الأكواد (code points) الموجودة في المصفوفة <code>codePoints</code> (بداية من العنصر ذو الفهرس <code>offset</code> وبطولٍ يساوي <code>length</code>) من جزء إلى [[Kotlin/String|سلسلة نصية]]. | ||
== القيم المعادة == | == القيم المعادة == |
مراجعة 11:45، 7 يوليو 2018
ينشِئ التابع 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.