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

مراجعة 14:17، 22 يوليو 2018

يحوِّل المعامل as الكائن الذي استُدعي عبره إلى نوعٍ آخر (T) بشكلٍ غير آمن (unsafe) أي بدون التحقُّق من الأنواع، فإن كان التحويل غير جائزٍ، فسيُعلِم المُترجم بوجود خطأٍ، ويعبِّر المعامل as عن استدعاء الدالة unsafeCast()‎ التي تقوم بالتحويل الفعليّ.

البنية العامة

inline fun <T> Any?.unsafeCast(): T

يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).

القيم المعادة

تعيد قيمة الكائن (object) بعد تحويله إلى النوع الآخر المُحدَّد (T).

أمثلة

استخدام المعامل `as` للتحويل غير الآمن (unsafe) لسلسلة نصية (string)

تعرّف الشيفرة الآتية متغيرًا باسم x من النوع Int، ثم تستخدم معامل التحويل غير الآمن as لتحويل هذا المتغيّر إلى سلسلةٍ نصيّة (string)، ولمّا كان ذلك غير جائزٍ فسيُعلِم المُترجم بوجود خطأ:

fun main(args: Array<String>) {
    val x:Int = 5
    val y: String? = x as String?  // error
}

ويُلاحَظ وجود المعامل ? عند النوع String للدلالة على أنّه nullable.

استخدام المعامل `as?`‎ للتحويل الآمن (safe) لسلسلة نصية (string)

تعرّف الشيفرة الآتية متغيرًا باسم x من النوع Int، ثم تستخدم معامل التحويل الآمن as?‎ لتحويل هذا المتغيّر إلى سلسلة نصيّة (string)، ولمّا كان ذلك غير جائزٍ فستُعيد القيمة null لذلك المتغير:

fun main(args: Array<String>) {
   val x:Int = 5
   val y: String? = x as? String?    
   print(y)   // null
}

انظر أيضًا

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة unsafeCast()‎ للتحويل غير الآمن بين الأنواع في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>‎‎unsafeCast()‎</code> للتحويل غير الآمن بين الأنواع في Kotlin}}</noinclude>
 يحوِّل المعامل <code>[[Kotlin/typecasts|as]]</code> الكائن الذي استُدعي عبره إلى نوعٍ  آخر (<code>T</code>) بشكلٍ غير آمن (unsafe) أي بدون التحقُّق من الأنواع، فإن  كان التحويل غير جائزٍ، فسيُعلِم المُترجم بوجود خطأٍ، ويعبِّر المعامل <code>[[Kotlin/typecasts|as]]</code> عن استدعاء الدالة <code>unsafeCast()‎</code> التي تقوم بالتحويل الفعليّ.
@@ سطر 8: / سطر 8: @@
 == القيم المعادة ==
-قيمة الكائن (object) بعد تحويله إلى النوع الآخر المُحدَّد (<code>T</code>).
+تعيد قيمة الكائن (object) بعد تحويله إلى النوع الآخر المُحدَّد (<code>T</code>).
 == أمثلة ==
@@ سطر 32: / سطر 32: @@
 == انظر أيضًا ==
-* [[Kotlin/typecasts|التحقُّق من الأنواع (type check) والتحويل بينها (casting) في لغة Kotlin]]
+* [[Kotlin/typecasts|التحقُّق من الأنواع (type check) والتحويل بينها (casting) في Kotlin]].
-* [[Kotlin/null safety|أمان القيم الفارغة (null) في لغة Kotlin]]
+* [[Kotlin/null safety|أمان القيم الفارغة (null) في Kotlin]].
-* [[Kotlin/basic types|أنواع البيانات (data types) في لغة Kotlin]]
+* [[Kotlin/basic types|أنواع البيانات (data types) في Kotlin]].
 == مصادر ==