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

المراجعة الحالية بتاريخ 11:33، 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]
}

انظر أيضًا

الدالة toCharArray()‎: تضع جميع محارف السلسلة النصية التي استٌدعيت معها في مصفوفة من النوع CharArray، إذ يوضع كل محرف في عنصر.
الدالة toCollection()‎: تضيف كل محارف السلسلة التي استٌدعيت معها إلى المجموعة المتغيرة المُمرّرة إليها.

الدالة toFloat()‎: تحلّل السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد عشري.
الدالة toHashSet()‎: تحلّل كائنًا من النوع HashSet يحوي كل محارف السلسلة التي استٌدعيت معها.
الدالة toInt()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح.
الدالة toList()‎: تضيف كل محارف سلسلة المحارف التي استٌدعيت معها إلى قائمة، إذ يوضع كل محرف في عنصر.
الدالة toLong()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد طويل.
الدالة toLowerCase()‎: تحول المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف صغيرة (lowercase).
الدالة toRegex()‎: تحول السلسلة النصية التي استٌدعيت معها إلى تعبير نمطي (regular expression).
الدالة toSet()‎: تضيف كل محارف سلسلة الحروف التي استٌدعيت معها إلى مجموعة من النوع Set، إذ يوضع كل محرف في عنصر.

مصادر

صفحة الدالة toByteArray()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع text.toByteArray()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>toByteArray()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>toByteArray()</code>‎ مصفوفة من النوع <code>[[Kotlin/ByteArray/index|ByteArray]]</code> تحتوي أكواد حروف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وفق الترميز المُمرّر <code>charset،</code> القيمة الابتدائية للوسيط <code>charset</code> هي <code>UTF_8</code>.
+ترمز الدالة <code>toByteArray()</code>‎ جميع محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها وفقًا لترميز محدد ثم تضع الناتج في مصفوفة من النوع <code>[[Kotlin/ByteArray|ByteArray]]</code>.
 == البنية العامة ==
@@ سطر 7: / سطر 7: @@
      charset: Charset = Charsets.UTF_8
 ): ByteArray
-</syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM'''
+</syntaxhighlight>'''بيئة التشغيل المطلوبة:''' JVM.
+يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
+== المعاملات ==
+=== <code>charset</code> ===
+اسم الترميز المراد تحويل محارف السلسلة النصية المعطاة إليه. القيمة الافتراضية هي: <code>Charsets.UTF_8</code>.
-يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 == القيم المعادة ==
-مصفوفة من النوع <code>[[Kotlin/ByteArray/index|ByteArray]]</code>.
+تعاد مصفوفة من النوع <code>[[Kotlin/ByteArray|ByteArray]]</code> تحوي ناتج ترميز جميع محارف [[Kotlin/String|السلسلة النصية]] المعطاة وفقًا للترميز <code>charset</code>.
 == أمثلة ==
-=== استخدام الدالة <code>toByteArray()‎</code> مع السلاسل النصية ===
+مث<nowiki/>الٌ على استعمال الدالة <code>toByteArray()‎</code>:<syntaxhighlight lang="kotlin">
-الشيفرة الآتية <nowiki/>تستدعي الدالة <code>toByteArray()‎</code> عبر عدة  [[Kotlin/String|سلاسل نصية]]، وتطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-println("wiki.hsoub.com".toByteArray().toList()) // [119, 105, 107, 105, 46, 104, 115, 111, 117, 98, 46, 99, 111, 109]
+    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>
 == انظر أيضًا ==
-* <code>[[Kotlin/text/toUpperCase|toUpperCase()]]</code>‎ : تحوّل الدالة <code>toUpperCase()</code>‎ الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).
+*الدالة [[Kotlin/kotlin.text/toCharArray|<code>toCharArray()</code>‎]]: تضع جميع محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها في مصفوفة من النوع <code>[[Kotlin/CharArray|CharArray]]</code>، إذ يوضع كل محرف في عنصر.
+*الدالة <nowiki/>[[Kotlin/kotlin.text/toCollection|<code>toCollection()</code>‎]]: تضيف كل محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استٌدعيت معها إلى المجموعة المتغيرة المُمرّرة إليها.
-*<code>[[Kotlin/text/isDefined|toBigDecimalOrNull()]]‎</code>: تحلّل الدالة <code>toBigDecimalOrNull()</code>‎ [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>BigDecimal</code>.
-*<code>[[Kotlin/kotlin.text/toBigDecimal|toBigDecimal()]]‎</code>: تحلّل الدالة <code>toBigDecimal()</code>‎ [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>BigDecimal</code>.
-* <code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
+*الدالة <nowiki/>[[Kotlin/kotlin.text/toFloat|<code>toFloat()</code>‎]]: تحلّل السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى <nowiki/>[[Kotlin/Float|عدد عشري]].
+*الدالة <nowiki/>[[Kotlin/kotlin.text/toHashSet|<code>toHashSet()</code>‎]]: تحلّل كائنًا من النوع <code>HashSet</code> يحوي كل محارف <nowiki/>[[Kotlin/CharSequence/index|السلسلة]] التي استٌدعيت معها.
+*الدالة <nowiki/>[[Kotlin/kotlin.text/toInt|<code>toInt()</code>‎]]: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح.
+*الدالة [[Kotlin/kotlin.text/toList|<code>toList()</code>‎]]: تضيف كل محارف [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها إلى [[Kotlin/collections/List|قائمة]]، إذ يوضع كل محرف في عنصر.
+*الدالة <code>[[Kotlin/kotlin.text/toLong|toLong()]]</code>‎: تحلّل [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها وتحوّلها إلى [[Kotlin/Long|عدد طويل]].
+*الدالة [[Kotlin/text/toLowerCase|<code>toLowerCase()</code>‎]]: تحول [[Kotlin/Char|المحرف]] أو جميع محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها إلى محارف صغيرة (lowercase).
+*الدالة [[Kotlin/kotlin.text/toRegex|<code>toRegex()</code>‎]]: تحول [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها إلى [[Kotlin/kotlin.text/Regex/index|تعبير نمطي]] (regular expression).
+*الدالة [[Kotlin/kotlin.text/toSet|<code>toSet()</code>‎]]: تضيف كل محارف [[Kotlin/CharSequence/index|سلسلة الحروف]]  التي استٌدعيت معها إلى مجموعة من النوع <code>[[Kotlin/Set|Set]]</code>، إذ يوضع كل محرف في عنصر.
 == مصادر ==
-* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-byte-array.html صفحة الدالة text.toByteArray()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-byte-array.html صفحة الدالة toByteArray()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]