الفرق بين المراجعتين ل"Kotlin/unsafeCast"
< Kotlin
اذهب إلى التنقل
اذهب إلى البحث
(مراجعة) |
جميل-بيلوني (نقاش | مساهمات) ط |
||
| (مراجعة متوسطة واحدة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
| − | <noinclude>{{DISPLAYTITLE: الدالة | + | <noinclude>{{DISPLAYTITLE: الدالة <code>unsafeCast()</code> للتحويل غير الآمن بين الأنواع في Kotlin}}</noinclude> |
| − | يحوِّل المعامل <code>[[Kotlin/typecasts|as]]</code> الكائن الذي استُدعي عبره إلى نوعٍ آخر (<code>T</code>) بشكلٍ غير آمن (unsafe) أي بدون التحقُّق من الأنواع، فإن كان التحويل غير جائزٍ، فسيُعلِم المُترجم بوجود خطأٍ، ويعبِّر المعامل <code>[[Kotlin/typecasts|as]]</code> عن استدعاء الدالة <code>unsafeCast()</code> التي | + | يحوِّل المعامل <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>). |
== أمثلة == | == أمثلة == | ||
| + | '''استخدام المعامل <code>as</code> للتحويل غير الآمن (unsafe) لسلسلة نصية (string):''' | ||
| − | |||
تعرّف الشيفرة الآتية متغيرًا باسم <code>x</code> من النوع <code>Int</code>، ثم تستخدم معامل التحويل غير الآمن <code>as</code> لتحويل هذا المتغيّر إلى سلسلةٍ نصيّة (string)، ولمّا كان ذلك غير جائزٍ فسيُعلِم المُترجم بوجود خطأ:<syntaxhighlight lang="kotlin"> | تعرّف الشيفرة الآتية متغيرًا باسم <code>x</code> من النوع <code>Int</code>، ثم تستخدم معامل التحويل غير الآمن <code>as</code> لتحويل هذا المتغيّر إلى سلسلةٍ نصيّة (string)، ولمّا كان ذلك غير جائزٍ فسيُعلِم المُترجم بوجود خطأ:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
| سطر 22: | سطر 22: | ||
ويُلاحَظ وجود المعامل <code>?</code> عند النوع <code>String</code> للدلالة على أنّه [[Kotlin/null safety|nullable]]. | ويُلاحَظ وجود المعامل <code>?</code> عند النوع <code>String</code> للدلالة على أنّه [[Kotlin/null safety|nullable]]. | ||
| − | + | '''استخدام المعامل <code>as?</code> للتحويل الآمن (safe) لسلسلة نصية (string):''' | |
| + | |||
تعرّف الشيفرة الآتية متغيرًا باسم <code>x</code> من النوع <code>Int</code>، ثم تستخدم معامل التحويل الآمن <code>as?</code> لتحويل هذا المتغيّر إلى سلسلة نصيّة (string)، ولمّا كان ذلك غير جائزٍ فستُعيد القيمة <code>null</code> لذلك المتغير:<syntaxhighlight lang="kotlin"> | تعرّف الشيفرة الآتية متغيرًا باسم <code>x</code> من النوع <code>Int</code>، ثم تستخدم معامل التحويل الآمن <code>as?</code> لتحويل هذا المتغيّر إلى سلسلة نصيّة (string)، ولمّا كان ذلك غير جائزٍ فستُعيد القيمة <code>null</code> لذلك المتغير:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
| سطر 32: | سطر 33: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
| − | * [[Kotlin/typecasts|التحقُّق من الأنواع (type check) والتحويل بينها (casting) في | + | * [[Kotlin/typecasts|التحقُّق من الأنواع (type check) والتحويل بينها (casting) في Kotlin]]. |
| − | * [[Kotlin/null safety|أمان القيم الفارغة (null) في | + | * [[Kotlin/null safety|أمان القيم الفارغة (null) في Kotlin]]. |
| − | * [[Kotlin/basic types|أنواع البيانات (data types) في | + | * [[Kotlin/basic types|أنواع البيانات (data types) في Kotlin]]. |
== مصادر == | == مصادر == | ||
| سطر 40: | سطر 41: | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Function]] | [[تصنيف:Kotlin Function]] | ||
| + | [[تصنيف:Kotlin JS]] | ||
المراجعة الحالية بتاريخ 05:46، 8 سبتمبر 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
}
انظر أيضًا
- التحقُّق من الأنواع (type check) والتحويل بينها (casting) في Kotlin.
- أمان القيم الفارغة (null) في Kotlin.
- أنواع البيانات (data types) في Kotlin.