الفرق بين المراجعتين ل"Kotlin/kotlin.text/isHighSurrogate"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع text.isHighSurrogate()‎ في لغة Kotlin}}</noinclude> تعيد الدالة <code>isHighSurrogate()</code>‎ القيمة <...')
 
(مراجعة وتدقيق.)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع text.isHighSurrogate()‎ في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: الدالة <code>isHighSurrogate()‎</code> في Kotlin}}</noinclude>
تعيد الدالة <code>isHighSurrogate()</code>‎ القيمة <code>true</code> في حال كان [[Kotlin/Char/index|الحرف]] الذي استٌدعيت عبره بديلًا علويًا (Unicode high-surrogate code unit).
+
تتحقق الدالة <code>isHighSurrogate()</code>‎ إن كان <nowiki/>[[Kotlin/Char|المحرف]] الذي استٌدعي معها بديلًا علويًا لعدد بتات الترميز الموحد (Unicode high-surrogate code unit).
 
== البنية العامة ==
 
== البنية العامة ==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
 
inline actual fun Char.isHighSurrogate(): Boolean  
 
inline actual fun Char.isHighSurrogate(): Boolean  
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
 
== القيم المعادة ==
 
== القيم المعادة ==
قيمة منطقية.
+
تعاد القيمة <code>true</code> إن كان <nowiki/>[[Kotlin/Char|المحرف]] المعطى بديلًا علويًا لعدد بتات الترميز الموحد، أو القيمة <code>false</code> خلاف ذلك.
  
 
== أمثلة ==
 
== أمثلة ==
 
+
مثالٌ على استعمال الدالة <code>isHighSurrogate()‎</code>:<syntaxhighlight lang="kotlin">
=== استخدام الدالة <code>isHighSurrogate()‎</code> مع الحروف ===
 
تُعرّف الشيفرة الآتية [[Kotlin/Char/index|حرفين]] <code>x</code> و <code>y</code> ثم تستدعي الدالة <code>isHighSurrogate()‎</code> عبرهما، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 
 
fun main(args: Array<String>) {     
 
fun main(args: Array<String>) {     
 
     val x = 'a'  
 
     val x = 'a'  
سطر 27: سطر 25:
 
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/is-high-surrogate.html صفحة الدالة isHighSurrogate()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/is-high-surrogate.html صفحة الدالة isHighSurrogate()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Method]]
+
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin Text]]
 +
[[تصنيف:Kotlin Char]]

مراجعة 06:28، 4 سبتمبر 2018

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

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

inline actual fun Char.isHighSurrogate(): Boolean

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

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

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

أمثلة

مثالٌ على استعمال الدالة isHighSurrogate()‎:

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

انظر أيضًا

  • equals(): تعيد القيمة true في حال كان الحرف أو السلسلة النصية التي استُدعيت عبرها مساوية للحرف أو السلسلة النصية المُمرّرة إليها. في حال تمرير الوسيط ignoreCase وإعطائه القيمة true فإنّ الدالة لن تفرق بين الحروف الصغيرة والكبيرة. القيمة الابتدائية للوسيط ignoreCase هيfalse.
  • isDefined(): تعيد القيمة true في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).

مصادر