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

مراجعة 11:17، 2 يوليو 2018

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

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

inline actual fun Char.isHighSurrogate(): Boolean

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

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

قيمة منطقية.

أمثلة

استخدام الدالة `isHighSurrogate()‎` مع الحروف

تُعرّف الشيفرة الآتية حرفين x و y ثم تستدعي الدالة 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).

مصادر

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

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