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

المراجعة الحالية بتاريخ 06:34، 4 سبتمبر 2018

تتحقق الدالة isTitleCase()‎ إن كان المحرف الذي استٌدعي معها محرفًا عُنوانيًا (titlecase). تتكون هذه المحارف عادةً من محرفين ملتصقين، مثل 'ǅ' أو 'ǋ'، إذ يعاملان وكأنَّهما محرفٌ واحدٌ فقط.

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

inline fun Char.isTitleCase(): Boolean

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

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

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

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

أمثلة

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

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

انظر أيضًا

الدالة equals()‎: تتحقق من تساوي محرفين أو سلسلتين نصيتين مع بعضهما بعضًا.
الدالة isBlank()‎: تتحقق إن كانت سلسلة المحارف التي استٌدعيت معها فارغةً أو تحوي محارف المسافات البيضاء (whitespace characters) فقط.
الدالة isEmpty()‎: تتحقق إن كانت سلسلة المحارف التي استٌدعيت معها فارغةً.
الدالة isNullOrEmpty()‎: تتحقق إن كانت سلسلة المحارف التي استٌدعيت معها تساوي null أو كانت فارغةً.
الدالة isDefined()‎: تتحقق إن كان المحرف (Unicode code point) الذي استٌدعيت معها مُعرّفًا في الترميز الموحَّد (Unicode) أم لا.
الدالة isDigit()‎: تتحقق إن كان المحرف الذي استٌدعيت معه رقمًا أم لا.
الدالة isIdentifierIgnorable()‎: تتحقق إن كان المحرف الذي استٌدعي معها محرفًا قابلًا للإهمال (ignorable character) في مُعرِّفات جافا (Java identifier) أو معرِّفات الترميز الموحَّد (Unicode identifier).

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

مصادر

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

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