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

من موسوعة حسوب
لا ملخص تعديل
مراجعة وتدقيق.
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع text.isSurrogate()‎ في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: التابع text.isSurrogate()‎ في لغة Kotlin}}</noinclude>
تعيد الدالة <code>isSurrogate()</code>‎ القيمة <code>true</code> في حال كان [[Kotlin/Char/index|الحرف]] الذي استٌدعيت عبره بديلًا لكود اليونيكود (Unicode surrogate code unit).
تتحقق الدالة <code>isSurrogate()</code>‎ إن كان [[Kotlin/Char|المحرف]] الذي استٌدعي معها بديلًا لعدد بتات الترميز الموحد (Unicode surrogate code unit).
== البنية العامة ==
== البنية العامة ==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
fun Char.isSurrogate(): Boolean  
fun Char.isSurrogate(): Boolean  
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
== القيم المعادة ==
== القيم المعادة ==
قيمة منطقية.
تعاد القيمة المنطقية <code>true</code> إن كان [[Kotlin/Char|المحرف]] الذي استٌدعي معها بديلًا لعدد بتات الترميز الموحد، أو القيمة <code>false</code> خلاف ذلك.


== أمثلة ==
== أمثلة ==
 
استعمال الدالة <code>isSurrogate()‎</code> لمعرفة أي المحرفيين التاليين هو بديل لعدد بتات الترميز الموحد:<syntaxhighlight lang="kotlin">
=== استخدام الدالة <code>isSurrogate()‎</code> مع الحروف ===
تُعرّف الشيفرة الآتية [[Kotlin/Char/index|حرفين]] <code>x</code> و <code>y</code> ثم تستدعي الدالة <code>isSurrogate()‎</code> عبرهما، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {     
fun main(args: Array<String>) {     
     val x = 'a'  
     val x = 'a'  

مراجعة 06:20، 13 أغسطس 2018

تتحقق الدالة isSurrogate()‎ إن كان المحرف الذي استٌدعي معها بديلًا لعدد بتات الترميز الموحد (Unicode surrogate code unit).

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

fun Char.isSurrogate(): Boolean

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

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

تعاد القيمة المنطقية true إن كان المحرف الذي استٌدعي معها بديلًا لعدد بتات الترميز الموحد، أو القيمة false خلاف ذلك.

أمثلة

استعمال الدالة isSurrogate()‎ لمعرفة أي المحرفيين التاليين هو بديل لعدد بتات الترميز الموحد:

fun main(args: Array<String>) {    
    val x = 'a' 
    val y = '\uDC00'
    
    print(x.isSurrogate()) // false
    print(y.isSurrogate()) // true
}

انظر أيضًا

  • isIdentifierIgnorable(): تعيد القيمة true في حال كان الحرف الذي استٌدعيت عبره يجب أن يُهمل في مُعرِّفات جافا (Java identifier) أو اليونيكود.
  • isHighSurrogate(): تعيد القيمة true في حال كان الحرف الذي استٌدعيت عبره بديلًا علويًا لكود اليونيكود (Unicode high-surrogate code unit).
  • isDefined(): تعيد القيمة true في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).

مصادر