الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/toByteArray»
< Kotlin | kotlin.text
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) مراجعة وتدقيق. |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: | <noinclude>{{DISPLAYTITLE: الدالة <code>toByteArray()</code> في Kotlin}}</noinclude> | ||
ترمز الدالة <code>toByteArray()</code> جميع محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها وفقًا لترميز محدد ثم تضع الناتج في مصفوفة من النوع <code>[[Kotlin/ByteArray|ByteArray]]</code>. | |||
== البنية العامة == | == البنية العامة == | ||
| سطر 7: | سطر 7: | ||
charset: Charset = Charsets.UTF_8 | charset: Charset = Charsets.UTF_8 | ||
): ByteArray | ): ByteArray | ||
</syntaxhighlight>'''بيئة التشغيل المطلوبة: | </syntaxhighlight>'''بيئة التشغيل المطلوبة:''' JVM. | ||
يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]). | |||
== المعاملات == | |||
=== <code>charset</code> === | |||
اسم الترميز المراد تحويل محارف السلسلة النصية المعطاة إليه. القيمة الافتراضية هي: <code>Charsets.UTF_8</code>. | |||
== القيم المعادة == | == القيم المعادة == | ||
مصفوفة من النوع <code>[[Kotlin/ByteArray/ | تعاد مصفوفة من النوع <code>[[Kotlin/ByteArray|ByteArray]]</code> تحوي ناتج ترميز جميع محارف [[Kotlin/String|السلسلة النصية]] المعطاة وفقًا للترميز <code>charset</code>. | ||
== أمثلة == | == أمثلة == | ||
مث<nowiki/>الٌ على استعمال الدالة <code>toByteArray()</code>:<syntaxhighlight lang="kotlin"> | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
println(" | println("wikiHsoub".toByteArray().toList()) // [119, 105, 107, 105, 72, 115, 111, 117, 98] | ||
println("3.14".toByteArray().toList()) // [51, 46, 49, 52] | println("3.14".toByteArray().toList()) // [51, 46, 49, 52] | ||
println("Aa".toByteArray(Charsets.UTF_16).toList()) // [-2, -1, 0, 65, 0, 97] | println("Aa".toByteArray(Charsets.UTF_16).toList()) // [-2, -1, 0, 65, 0, 97] | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| سطر 33: | سطر 37: | ||
== مصادر == | == مصادر == | ||
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-byte-array.html صفحة الدالة | * [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-byte-array.html صفحة الدالة toByteArray() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin | [[تصنيف:Kotlin Function]] | ||
[[تصنيف:Kotlin Text]] | |||
مراجعة 06:10، 6 سبتمبر 2018
ترمز الدالة toByteArray() جميع محارف السلسلة النصية التي استٌدعيت معها وفقًا لترميز محدد ثم تضع الناتج في مصفوفة من النوع ByteArray.
البنية العامة
inline fun String.toByteArray(
charset: Charset = Charsets.UTF_8
): ByteArray
بيئة التشغيل المطلوبة: JVM.
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)).
المعاملات
charset
اسم الترميز المراد تحويل محارف السلسلة النصية المعطاة إليه. القيمة الافتراضية هي: Charsets.UTF_8.
القيم المعادة
تعاد مصفوفة من النوع ByteArray تحوي ناتج ترميز جميع محارف السلسلة النصية المعطاة وفقًا للترميز charset.
أمثلة
مثالٌ على استعمال الدالة toByteArray():
fun main(args: Array<String>) {
println("wikiHsoub".toByteArray().toList()) // [119, 105, 107, 105, 72, 115, 111, 117, 98]
println("3.14".toByteArray().toList()) // [51, 46, 49, 52]
println("Aa".toByteArray(Charsets.UTF_16).toList()) // [-2, -1, 0, 65, 0, 97]
}
انظر أيضًا
toUpperCase() : تحوّل الدالةtoUpperCase() الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).
toBigDecimalOrNull(): تحلّل الدالةtoBigDecimalOrNull() السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوعBigDecimal.toBigDecimal(): تحلّل الدالةtoBigDecimal() السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوعBigDecimal.
isDefined(): تعيد القيمةtrueفي حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).