الفرق بين المراجعتين لصفحة: «Kotlin/unsafeCast»
< Kotlin
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة unsafeCast() للتحويل غير الآمن بين الأنواع في لغة Kotlin}}</noinclude> يحوِّل المعا...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة unsafeCast() للتحويل غير الآمن بين الأنواع في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة unsafeCast() للتحويل غير الآمن بين الأنواع في لغة Kotlin}}</noinclude> | ||
يحوِّل المعامل as الكائن الذي استُدعي عبره إلى نوعٍ آخر (T) بشكل غير آمن (unsafe)، أي بدون التحقق من الأنواع، فإن كان التحويل غير جائزٍ، فسيُعلِم المُترجم بوجود خطأ، ويعبِّر المعامل as عن استدعاء الدالة unsafeCast() التي تقوم بالتحويل الفعليّ. | يحوِّل المعامل <code>as</code> الكائن الذي استُدعي عبره إلى نوعٍ آخر (<code>T</code>) بشكل غير آمن (unsafe)، أي بدون التحقق من الأنواع، فإن كان التحويل غير جائزٍ، فسيُعلِم المُترجم بوجود خطأ، ويعبِّر المعامل <code>as</code> عن استدعاء الدالة <code>unsafeCast()</code> التي تقوم بالتحويل الفعليّ. | ||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="kotlin"> | |||
inline fun <T> Any?.unsafeCast(): T | inline fun <T> Any?.unsafeCast(): T | ||
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع [[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | |||
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع [[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | |||
== القيم المعادة == | == القيم المعادة == | ||
قيمة الكائن بعد تحويله إلى | قيمة الكائن بعد تحويله إلى النوع الآخر المُحدَّد (<code>T</code>). | ||
== أمثلة == | == أمثلة == | ||
=== استخدام المعامل as للتحويل غير الآمن لسلسلة نصية === | === استخدام المعامل <code>as</code> للتحويل غير الآمن لسلسلة نصية === | ||
تعرّف الشيفرة الآتية متغيرًا باسم x من النوع | تعرّف الشيفرة الآتية متغيرًا باسم <code>x</code> من النوع <code>Int</code>، ثم تستخدم معامل التحويل غير الآمن <code>as</code> لتحويله إلى سلسلة نصية (string)، ولما كان ذلك غير جائز، فسيُعلِم المُترجم بوجود خطأ:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val x:Int = 5 | val x:Int = 5 | ||
val y: String? = x as String? // error | val y: String? = x as String? // error | ||
} | } | ||
</syntaxhighlight> | |||
ويُلاحظ وجود المعامل ? عند النوع String للدلالة على أنّه [[Kotlin/null safety|nullable]]. | ويُلاحظ وجود المعامل <code>?</code> عند النوع <code>String</code> للدلالة على أنّه [[Kotlin/null safety|nullable]]. | ||
=== استخدام المعامل <code>as?</code> للتحويل الآمن لسلسلة نصية === | |||
تعرّف الشيفرة الآتية متغيرًا باسم x من النوع <code>Int</code>، ثم تستخدم معامل التحويل الآمن <code>as?</code> لتحويله إلى سلسلة نصية (string)، ولما كان ذلك غير جائز، فستُعيد القيمة <code>null</code> لذلك المتغير:<syntaxhighlight lang="kotlin"> | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val x:Int = 5 | val x:Int = 5 | ||
val y: String? = x as? String? | |||
print(x) // null | print(x) // null | ||
} | } | ||
</syntaxhighlight> | |||
== انظر أيضًا == | == انظر أيضًا == | ||
| سطر 46: | سطر 38: | ||
== مصادر == | == مصادر == | ||
* الدالة unsafeCast() للتحويل غير الآمن في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin | * [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.js/unsafe-cast.html الدالة unsafeCast() للتحويل غير الآمن في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] | ||
مراجعة 16:39، 9 مايو 2018
يحوِّل المعامل as الكائن الذي استُدعي عبره إلى نوعٍ آخر (T) بشكل غير آمن (unsafe)، أي بدون التحقق من الأنواع، فإن كان التحويل غير جائزٍ، فسيُعلِم المُترجم بوجود خطأ، ويعبِّر المعامل as عن استدعاء الدالة unsafeCast() التي تقوم بالتحويل الفعليّ.
البنية العامة
inline fun <T> Any?.unsafeCast(): T
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المعادة
قيمة الكائن بعد تحويله إلى النوع الآخر المُحدَّد (T).
أمثلة
استخدام المعامل as للتحويل غير الآمن لسلسلة نصية
تعرّف الشيفرة الآتية متغيرًا باسم x من النوع Int، ثم تستخدم معامل التحويل غير الآمن as لتحويله إلى سلسلة نصية (string)، ولما كان ذلك غير جائز، فسيُعلِم المُترجم بوجود خطأ:
fun main(args: Array<String>) {
val x:Int = 5
val y: String? = x as String? // error
}
ويُلاحظ وجود المعامل ? عند النوع String للدلالة على أنّه nullable.
استخدام المعامل as? للتحويل الآمن لسلسلة نصية
تعرّف الشيفرة الآتية متغيرًا باسم x من النوع Int، ثم تستخدم معامل التحويل الآمن as? لتحويله إلى سلسلة نصية (string)، ولما كان ذلك غير جائز، فستُعيد القيمة null لذلك المتغير:
fun main(args: Array<String>) {
val x:Int = 5
val y: String? = x as? String?
print(x) // null
}
انظر أيضًا
- التحقق من الأنواع (Type Check) والتحويل بينها (Casting) في لغة Kotlin
- أمان القيم الفارغة (Null) في لغة Kotlin
- أنواع البيانات (Data Types) في لغة Kotlin