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

المراجعة الحالية بتاريخ 04:46، 9 سبتمبر 2018

تتحقق الدالة isISOControl()‎ إن كان المحرف الذي استٌدعي معها هو أحد محارف تحكمISO ‎‎‏ ‎ISO control character)‎‎‎).

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

inline fun Char.isISOControl(): Boolean

المنصة المطلوبة: JVM.

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

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

تعاد القيمة true إن كان المحرف المعطى هو أحد محارف تحكمISO ‎‎‏، أو القيمة false خلاف ذلك.

أمثلة

استعمال الدالة isISOControl()‎ لمعرفة أيُّ المحرفين التاليين هو من أحد محارف تحكم ISO:

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

انظر أيضًا

الدالة equals()‎: تتحقق من تساوي محرفين أو سلسلتين نصيتين مع بعضهما بعضًا.
الدالة isDefined()‎: تتحقق إن كان المحرف (Unicode code point) الذي استٌدعيت معها مُعرّفًا في الترميز الموحَّد (Unicode) أم لا.
الدالة isDigit()‎: تتحقق إن كان المحرف الذي استٌدعيت معه رقمًا أم لا.
الدالة isHighSurrogate()‎: تتحقق إن كان المحرف الذي استٌدعي معها بديلًا علويًا لعدد بتات الترميز الموحد (Unicode high-surrogate code unit).
الدالة isIdentifierIgnorable()‎: تتحقق إن كان المحرف الذي استٌدعي معها محرفًا قابلًا للإهمال (ignorable character) في مُعرِّفات جافا (Java identifier) أو معرِّفات الترميز الموحَّد (Unicode identifier).
الدالة isJavaIdentifierPart()‎: تتحقق إن كان من المحتمل أن يكون المحرف الذي استٌدعي معها جزءًا من مُعرِّف جافا (Java identifier) وليس المحرف الأول من المُعرّف.
الدالة isJavaIdentifierStart()‎: تتحقق إن كان يسمح أن يكون المحرف الذي استٌدعي معها المحرف الأول من مُعرِّف جافا (Java identifier).

الدالة isLetter()‎: تتحقق إن كان المحرف (character) الذي استٌدعي معها حرفًا أبجديًا.
الدالة isLetterOrDigit()‎: تتحقق إن كان المحرف (character) الذي استٌدعي معها حرفًا أبجديًا أو رقمًا.
الدالة isLowSurrogate()‎: تتحقق إن كان المحرف الذي استٌدعي معها بديلًا سفليًّا لعدد بتات الترميز الموحد (Unicode low-surrogate code unit).
الدالة isLowerCase()‎: تتحقق إن كان الحرف الذي استٌدعي معها حرفًا صغيرًا (lower case).
الدالة isSurrogate()‎: تتحقق إن كان المحرف الذي استٌدعي معها بديلًا لعدد بتات الترميز الموحد (Unicode surrogate code unit).
الدالة isTitleCase()‎: تتحقق إن كان المحرف الذي استٌدعي معها محرفًا عُنوانيًا (titlecase). تتكون هذه المحارف عادةً من محرفين ملتصقين، مثل 'ǅ' أو 'ǋ'، إذ يعاملان وكأنهما محرف واحد فقط.
الدالة isUpperCase()‎: تتحقق إن كان الحرف الذي استٌدعي معها حرفًا كبيرًا (upper case).
الدالة isWhitespace()‎: تتحقق إن كان المحرف الذي استٌدعي معها هو مسافة بيضاء (whitespace).

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع text.isISOControl()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE:الدالة <code>text.isISOControl()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>isISOControl()</code>‎ القيمة <code>true</code> في حال كان [[Kotlin/Char/index|الحرف]] الذي استٌدعيت عبره بديلًا علويًا (Unicode high-surrogate code unit).
+تتحقق الدالة <code>isISOControl()</code>‎ إن كان [[Kotlin/Char|المحرف]] الذي استٌدعي معها هو أحد محارف تحكمISO ‎‎‏ ‎ISO control character)‎‎‎).
 == البنية العامة ==
 <syntaxhighlight lang="kotlin">
-inline actual fun Char.isHighSurrogate(): Boolean
+inline fun Char.isISOControl(): Boolean
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+</syntaxhighlight>المنصة المطلوبة: '''JVM'''.
+وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
 == القيم المعادة ==
-قيمة منطقية.
+تعاد القيمة <code>true</code> إن كان المحرف المعطى هو أحد محارف تحكمISO ‎‎‏، أو القيمة <code>false</code> خلاف ذلك.
 == أمثلة ==
+استعمال الدالة <code>isISOControl()‎</code> لمعرفة أيُّ المحرفين التاليين هو من أحد محارف تحكم ISO:<syntaxhighlight lang="kotlin">
-=== استخدام الدالة <code>isISOControl()‎</code> مع الحروف ===
-تُعرّف الشيفرة الآتية [[Kotlin/Char/index|حرفين]] <code>x</code> و <code>y</code> ثم تستدعي الدالة <code>isISOControl()‎</code> عبرهما، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
      val x = 'a'
-     val y = '\uD800'
+     val y = '\u0000' // null character
-    print(x.isHighSurrogate()) // false
+	print(x.isISOControl()) // false
-     print(y.isHighSurrogate()) // true
+     print(y.isISOControl()) // true
 }
 </syntaxhighlight>
 == انظر أيضًا ==
-* <code>[[Kotlin/text/equals|equals()]]‎</code>: تعيد  القيمة <code>true</code> في حال كان الحرف أو السلسلة النصية التي استُدعيت عبرها مساوية للحرف أو السلسلة النصية المُمرّرة إليها. في حال تمرير الوسيط <code>ignoreCase</code> وإعطائه القيمة <code>true</code> فإنّ الدالة لن تفرق بين الحروف الصغيرة والكبيرة. القيمة الابتدائية للوسيط <code>ignoreCase</code> هي<code>false</code>.
+*الدالة [[Kotlin/text/equals|<code>equals()</code>‎]]: تتحقق من تساوي محرفين أو سلسلتين نصيتين مع بعضهما بعضًا.
-* <code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
+*الدالة [[Kotlin/text/isDefined|<code>isDefined()</code>‎]]: تتحقق إن كان [[Kotlin/Char|المحرف]] (Unicode code point) الذي استٌدعيت معها مُعرّفًا في الترميز الموحَّد (Unicode) أم لا.
+*الدالة [[Kotlin/text/isDigit|<code>isDigit()</code>‎]]: تتحقق إن كان [[Kotlin/Char|المحرف]] الذي استٌدعيت معه رقمًا أم لا.
+*الدالة [[Kotlin/text/isHighSurrogate|<code>isHighSurrogate()</code>‎]]: تتحقق إن كان [[Kotlin/Char|المحرف]] الذي استٌدعي معها بديلًا علويًا لعدد بتات الترميز الموحد (Unicode high-surrogate code unit).
+*الدالة [[Kotlin/text/isIdentifierIgnorable|<code>isIdentifierIgnorable()</code>‎]]: تتحقق إن كان [[Kotlin/Char|المحرف]] الذي استٌدعي معها محرفًا قابلًا للإهمال (ignorable character) في مُعرِّفات جافا (Java identifier) أو معرِّفات الترميز الموحَّد (Unicode identifier).
+*الدالة [[Kotlin/text/isJavaIdentifierPart|<code>isJavaIdentifierPart()</code>‎]]: تتحقق إن كان من المحتمل أن يكون [[Kotlin/Char|المحرف]] الذي استٌدعي معها جزءًا من مُعرِّف جافا (Java identifier) وليس المحرف الأول من المُعرّف.
+*الدالة [[Kotlin/text/isJavaIdentifierStart|<code>isJavaIdentifierStart()</code>‎]]: تتحقق إن كان يسمح أن يكون [[Kotlin/Char|المحرف]] الذي استٌدعي معها المحرف الأول من مُعرِّف جافا (Java identifier).
+* الدالة <nowiki/>[[Kotlin/text/isLetter|<code>isLetter()</code>‎]]: تتحقق إن كان المحرف (character) الذي استٌدعي معها حرفًا أبجديًا.
+* الدالة <nowiki/>[[Kotlin/text/isLetterOrDigit|<code>isLetterOrDigit()</code>‎]]: تتحقق إن كان المحرف (character) الذي استٌدعي معها حرفًا أبجديًا أو رقمًا.
+* الدالة <nowiki/>[[Kotlin/text/isLowSurrogate|<code>isLowSurrogate()</code>‎]]: تتحقق إن كان المحرف الذي استٌدعي معها بديلًا سفليًّا لعدد بتات الترميز الموحد (Unicode low-surrogate code unit).
+* الدالة <nowiki/>[[Kotlin/text/isLowerCase|<code>isLowerCase()</code>‎]]: تتحقق إن كان الحرف الذي استٌدعي معها حرفًا صغيرًا (lower case).
+* الدالة <nowiki/>[[Kotlin/text/isSurrogate|<code>isSurrogate()</code>‎]]: تتحقق إن كان المحرف الذي استٌدعي معها بديلًا لعدد بتات الترميز الموحد (Unicode surrogate code unit).
+* الدالة <nowiki/>[[Kotlin/text/isTitleCase|<code>isTitleCase()</code>‎]]: تتحقق إن كان المحرف الذي استٌدعي معها محرفًا عُنوانيًا (titlecase). تتكون هذه المحارف عادةً من محرفين ملتصقين، مثل <code>'ǅ'</code> أو <code>'ǋ'</code>، إذ يعاملان وكأنهما محرف واحد فقط.
+* الدالة <nowiki/>[[Kotlin/text/isUpperCase|<code>isUpperCase()</code>‎]]: تتحقق إن كان الحرف الذي استٌدعي معها حرفًا كبيرًا (upper case).
+* الدالة <nowiki/>[[Kotlin/text/isWhitespace|<code>isWhitespace()</code>‎]]: تتحقق إن كان المحرف الذي استٌدعي معها هو مسافة بيضاء (whitespace).
 == مصادر ==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/is-high-surrogate.html صفحة الدالة isISOControl()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/is-i-s-o-control.html صفحة الدالة isISOControl()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin Char]]