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

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

يمثل الصنف Char محرفًا بحجم 16 بت مرمزًا بالترميز الموحَّد (Unicode). في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثَّل كقيم للنوع char الأساسي.

class Char : Comparable<Char>

الدوال

`compareTo`

توازن الدالة compareTo()‎ بين قيمة المحرف الذي استُدعي معها والقيمة المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة المحرف الذي استُدعي معها) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية.

`dec`

تعيد الدالة dec()‎ المحرف السابق للمحرف الذي استُدعيت معه.

`inc`

تعيد الدالة inc()‎ المحرف اللاحق للمحرف الذي استُدعيت معه.

`minus`

تطرح الدالة minus()‎ القيمة العددية للمحرف الممرّر إليها من القيمة العددية للمحرف المستدعى معها ثمَّ تعيد عددًا من النوع Int يمثل الناتج. وإن مرِّر إليها عدد صحيح من النوع Int، فستعيد المحرف الذي تساوي قيمته العددية حاصل طرح هذا العدد من القيمة العددية للحرف الذي استُدعيت معه.

`plus`

تجمع الدالة plus()‎ القيمة العددية الممرَّرة إليها مع القيمة العددية للمحرف المستدعى معها ثمَّ تعيد المحرف الذي يقابل القيمة الناتجة.

`rangeTo`

تنشئ الدالة rangeTo()‎ مجالًا يقع بين المحرف الذي استدعي معها والمحرف المُمرّر إليها.

`toByte`

تحوّل الدالة toByte()‎ المحرف الذي استُدعي معها إلى عدد من النوع Byte.

`toChar`

تحول الدالة toChar()‎ القيمة العددية للمحرف الذي استُدعي معها إلى المحرف المقابل (أي من النوع Char).

`toDouble`

تحوّل الدالة toDouble()‎ المحرف الذي استُدعي معها إلى عدد عشري مضاعف (أي من النوع Double).

`toFloat`

تحوّل الدالة toFloat()‎ المحرف الذي استُدعي معها إلى عدد عشري (أي من النوع Float).

`toInt`

تحوّل الدالة toInt()‎ المحرف الذي استُدعي معها إلى عدد صحيح (أي من النوع Int).

`toLong`

تحوّل الدالة toLong()‎ المحرف الذي استُدعي معه إلى عدد من النوع Long.

`toShort`

تحوّل الدالة toShort()‎ المحرف الذي استُدعي معها إلى عدد من النوع Short.

الخاصيات المُصاحبة (Companion Object Properties)

`MAX_HIGH_SURROGATE`

يمثِّل الثابت Char.MAX_HIGH_SURROGATE القيمة القصوى للبديل الأعلى لعدد بتات الترميز الموحد (Unicode high-surrogate code unit).

`MAX_LOW_SURROGATE`

يمثل الثابت Char.MAX_LOW_SURROGATE القيمة القصوى للبديل الأدنى لعدد بتات الترميز الموحد (Unicode low-surrogate code unit).

`MAX_SURROGATE`

يمثِّل الثابت Char.MAX_SURROGATE القيمة القصوى لبديل لعدد بتات الترميز الموحد (Unicode surrogate code unit).

`MIN_HIGH_SURROGATE`

يمثل الثابت Char.MIN_HIGH_SURROGATE القيمة الدنيا للبديل الأعلى لعدد بتات الترميز الموحد (Unicode high-surrogate code unit).

`MIN_LOW_SURROGATE`

يمثل الثابت Char.MIN_LOW_SURROGATE القيمة الدنيا للبديل الأدنى لعدد بتات الترميز الموحد (Unicode low-surrogate code unit).

`MIN_SURROGATE`

يمثل الثابت Char.MIN_SURROGATE القيمة الدنيا لبديل لعدد بتات الترميز الموحد (Unicode surrogate code unit).

الخاصيات الإضافية (Extension Properties)

`category`

تعيد category قيمة تبيّن الفئة العامة للحرف.

`directionality`

تعيد directionality اتجاه الحرف (Unicode directionality property) الذي استُدعيت عبره.

الدوال الإضافية (Extension Functions)

`downTo`

تنشئ الدالة ‎downTo()‎ مجالًا متدرجًا (progression) يبدًأ من القيمة القصوى التي استُدعيت معها وينحدر تنازليًّا حتى يصل إلى القيمة الممرّرة إليها.

`equals`

تتحقق الدالة equals()‎ من تساوي محرفين أو سلسلتين نصيتين مع بعضهما بعضًا.

`isDefined`

تتحقق الدالة isDefined()‎ إن كان المحرف (Unicode code point) الذي استٌدعيت معها مُعرّفًا في الترميز الموحَّد (Unicode) أم لا.

`isDigit`

تتحقق الدالة isDigit()‎ إن كان المحرف الذي استٌدعيت معه رقمًا أم لا.

`isHighSurrogate`

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

`isISOControl`

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

`isIdentifierIgnorable`

تتحقق الدالة isIdentifierIgnorable()‎ إن كان المحرف الذي استٌدعي معها محرفًا قابلًا للإهمال (ignorable character) في مُعرِّفات جافا (Java identifier) أو معرِّفات الترميز الموحَّد (Unicode identifier).

`isJavaIdentifierPart`

تتحقق الدالة isJavaIdentifierPart()‎ إن كان من المحتمل أن يكون المحرف الذي استٌدعي معها جزءًا من مُعرِّف جافا (Java identifier) وليس المحرف الأول من المُعرّف.

`isJavaIdentifierStart`

تتحقق الدالة isJavaIdentifierStart()‎ إن كان يُسمَح أن يكون المحرف الذي استٌدعي معها المحرف الأول من مُعرِّف جافا (Java identifier).

`isLetter`

تتحقق الدالة isLetter()‎ إن كان المحرف (character) الذي استٌدعي معها حرفًا أبجديًا.

`isLetterOrDigit`

تتحقق الدالة isLetterOrDigit()‎ إن كان المحرف (character) الذي استٌدعي معها حرفًا أبجديًا أو رقمًا.

`isLowSurrogate`

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

`isLowerCase`

تتحقق الدالة isLowerCase()‎ إن كان الحرف الذي استٌدعي معها حرفًا صغيرًا (lower case).

`isSurrogate`

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

`isTitleCase`

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

`isUpperCase`

تتحقق الدالة isUpperCase()‎ إن كان الحرف الذي استٌدعي معها حرفًا كبيرًا (upper case).

`isWhitespace`

تتحقق الدالة isWhitespace()‎ إن كان المحرف الذي استٌدعي معها هو مسافة بيضاء (whitespace).

`plus`

تضيف الدالة plus()‎ الحرف الذي استٌدعي معها إلى بداية السلسلة النصية المُمرّرة إليها.

`toLowerCase`

تحوّل الدالة toLowerCase()‎ المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف صغيرة (lowercase).

`toTitleCase`

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

`toUpperCase`

تحوّل الدالة toUpperCase()‎ المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف كبيرة (uppercase).

`until`

تنشئ الدالة ‎until()‎ مجالًا (range) تصاعديًا يبدأ القيمة التي استُدعيت معها وحتى القيمة الممرّرة إليها (لا تدخل هذه القيمة ضمن المجال).

مصادر

صفحة الصنف Char في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
+يمثل الصنف <code>Char</code> محرفًا بحجم 16 بت مرمزًا بالترميز الموحَّد (Unicode). في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثَّل كقيم للنوع <code>char</code> الأساسي.<syntaxhighlight lang="kotlin">
+class Char : Comparable<Char>
+</syntaxhighlight>
 == الدوال ==
 <noinclude>{{DISPLAYTITLE:الصنف <code>‎‎Char</code>‎ في Kotlin}}</noinclude>
 === <code>[[Kotlin/Char/compareTo|compareTo]]</code> ===
-تقارن الدالة<code>compareTo()‎</code> بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة <code>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة .
+توازن الدالة <code>compareTo()‎</code> بين قيمة المحرف الذي استُدعي معها والقيمة المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة المحرف الذي استُدعي معها) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية.
 === <code>[[Kotlin/Char/dec|dec]]</code> ===
-تعيد الدالة<code>dec()‎</code> الحرف السابق على الحرف الذي استُدعيت عبره.
+تعيد الدالة <code>dec()‎</code> المحرف السابق للمحرف الذي استُدعيت معه.
 === <code>[[Kotlin/Char/inc|inc]]</code> ===
-تعيد الدالة<code>inc()‎</code> الحرف الموالي للحرف الذي استُدعيت عبره.
+تعيد الدالة <code>inc()‎</code> المحرف اللاحق للمحرف الذي استُدعيت معه.
 === <code>[[Kotlin/Char/minus|minus]]</code> ===
-تقوم الدالة<code>minus()‎</code> بطرح ترتيب الحرف الممرّر من ترتيب الحرف الذي استُدعيت عبره وتعيد عددا من النوع <code>Int</code>. أما إن كان الوسيط المُمرّر عددًا، فإنّها تعيد الحرف الذي يساوي الفرق بين ترتيبه وترتيب الحرف الذي استُدعيت عبره العدد المٌمرّر.
+تطرح الدالة <code>minus()‎</code> القيمة العددية للمحرف الممرّر إليها من القيمة العددية للمحرف المستدعى معها ثمَّ تعيد عددًا من النوع <code>Int</code> يمثل الناتج. وإن مرِّر إليها عدد صحيح من النوع <code>Int</code>، فستعيد المحرف الذي تساوي قيمته العددية حاصل طرح هذا العدد من القيمة العددية للحرف الذي استُدعيت معه.
 === <code>[[Kotlin/Char/plus|plus]]</code> ===
-تعيد الدالة<code>plus()‎</code> الحرف الذي يوجد بعد الحرف الذي استُدعيت عبره بالعدد المٌمرّر.
+تجمع الدالة <code>plus()‎</code> القيمة العددية الممرَّرة إليها مع القيمة العددية للمحرف المستدعى معها ثمَّ تعيد المحرف الذي يقابل القيمة الناتجة.
 === <code>[[Kotlin/Char/rangeTo|rangeTo]]</code> ===
-تنشئ الدالة<code>rangeTo()‎</code> مجالًا من العنصر الذي استُدعيت عبره إلى القيمة المُمرّرة.
+تنشئ الدالة <code>rangeTo()‎</code> مجالًا يقع بين المحرف الذي استدعي معها والمحرف المُمرّر إليها.
 === <code>[[Kotlin/Char/toByte|toByte]]</code> ===
-تحوّل الدالة<code>toByte()‎</code> الحرف الذي استُدعيت عبره إلى عدد من النوع <code>[[Kotlin/Byte/index|Byte]]</code>.
+تحوّل الدالة <code>toByte()‎</code> المحرف الذي استُدعي معها إلى عدد من النوع <code>[[Kotlin/Byte|Byte]]</code>.
 === <code>[[Kotlin/Char/toChar|toChar]]</code> ===
-تعيد الدالة<code>toChar()‎</code> الحرف الذي استُدعيت عبره على شكل عنصر من النوع <code>Char</code>.
+تحول الدالة <code>toChar()‎</code> القيمة العددية للمحرف الذي استُدعي معها إلى المحرف المقابل (أي من النوع <code>[[Kotlin/Char|Char]]</code>).
 === <code>[[Kotlin/Char/toDouble|toDouble]]</code> ===
-تحوّل الدالة<code>toDouble()‎</code> الحرف الذي استُدعيت عبره إلى عدد من النوع <code>[[Kotlin/Double/index|Double]]</code>.
+تحوّل الدالة <code>toDouble()‎</code> المحرف الذي استُدعي معها إلى عدد عشري مضاعف (أي من النوع <code>[[Kotlin/Double|Double]]</code>).
 === <code>[[Kotlin/Char/toFloat|toFloat]]</code> ===
-تحوّل الدالة<code>toFloat()‎</code> الحرف الذي استُدعيت عبره إلى عدد من النوع <code>[[Kotlin/Float/index|Float]]</code>.
+تحوّل الدالة <code>toFloat()‎</code> المحرف الذي استُدعي معها إلى عدد عشري (أي من النوع <code>[[Kotlin/Float|Float]]</code>).
 === <code>[[Kotlin/Char/toInt|toInt]]</code> ===
-تحوّل الدالة<code>toInt()‎</code> الحرف الذي استُدعيت عبره إلى عدد من النوع <code>Int</code>.
+تحوّل الدالة <code>toInt()‎</code> المحرف الذي استُدعي معها إلى عدد صحيح (أي من النوع <code>Int</code>).
 === <code>[[Kotlin/Char/toLong|toLong]]</code> ===
-تحوّل الدالة<code>toLong()‎</code> الحرف الذي استُدعيت عبره إلى عدد من النوع <code>Long</code>.
+تحوّل الدالة <code>toLong()‎</code> المحرف الذي استُدعي معه إلى عدد من النوع <code>Long</code>.
 === <code>[[Kotlin/Char/toShort|toShort]]</code> ===
-تحوّل الدالة<code>toShort()‎</code> الحرف الذي استُدعيت عبره إلى عدد من النوع <code>Short</code>.
+تحوّل الدالة <code>toShort()‎</code> المحرف الذي استُدعي معها إلى عدد من النوع <code>Short</code>.
 == الخاصيات المُصاحبة (Companion Object Properties) ==
 === <code>[[Kotlin/Char/MAX_HIGH_SURROGATE|MAX_HIGH_SURROGATE]]</code> ===
-تساوي الثابتة<code>MAX_HIGH_SURROGATE</code> القيمة القصوى للبديل الأعلى لوحدة اليونيكود (Unicode high-surrogate code unit).
+يمثِّل الثابت <code>Char.MAX_HIGH_SURROGATE</code> القيمة القصوى للبديل الأعلى لعدد بتات الترميز الموحد (Unicode high-surrogate code unit).
 === <code>[[Kotlin/Char/MAX_LOW_SURROGATE|MAX_LOW_SURROGATE]]</code> ===
-تساوي الثابتة<code>MAX_HIGH_SURROGATE</code> القيمة القصوى للبديل الأدنى لوحدة اليونيكود (Unicode low-surrogate code unit).
+يمثل الثابت <code>Char.MAX_LOW_SURROGATE </code> القيمة القصوى للبديل الأدنى لعدد بتات الترميز الموحد (Unicode low-surrogate code unit).
 === <code>[[Kotlin/Char/MAX_SURROGATE|MAX_SURROGATE]]</code> ===
-تساوي الثابتة<code>MAX_SURROGATE</code> القيمة القصوى لبديل وحدة اليونيكود (Unicode surrogate code unit).
+يمثِّل الثابت <code>Char.MAX_SURROGATE</code> القيمة القصوى لبديل لعدد بتات الترميز الموحد (Unicode surrogate code unit).
 === <code>[[Kotlin/Char/MIN_HIGH_SURROGATE|MIN_HIGH_SURROGATE]]</code> ===
-تساوي الثابتة<code>MIN_HIGH_SURROGATE</code> القيمة الدنيا للبديل الأعلى لوحدة اليونيكود (Unicode high-surrogate code unit).
+يمثل الثابت <code>Char.MIN_HIGH_SURROGATE</code> القيمة الدنيا للبديل الأعلى لعدد بتات الترميز الموحد (Unicode high-surrogate code unit).
 === <code>[[Kotlin/Char/MIN_LOW_SURROGATE|MIN_LOW_SURROGATE]]</code> ===
-تساوي الثابتة<code>MIN_LOW_SURROGATE</code> القيمة الدنيا للبديل الأدنى لوحدة اليونيكود (Unicode low-surrogate code unit).
+يمثل الثابت <code>Char.MIN_LOW_SURROGATE</code> القيمة الدنيا للبديل الأدنى لعدد بتات الترميز الموحد (Unicode low-surrogate code unit).
 === <code>[[Kotlin/Char/MIN_SURROGATE|MIN_SURROGATE]]</code> ===
-تساوي الثابتة<code>MIN_SURROGATE</code> القيمة الدنيا لبديل وحدة اليونيكود (Unicode surrogate code unit).
+يمثل الثابت <code>Char.MIN_SURROGATE</code> القيمة الدنيا لبديل لعدد بتات الترميز الموحد (Unicode surrogate code unit).
 == الخاصيات الإضافية (Extension Properties) ==
@@ سطر 71: / سطر 75: @@
 === <code>[[Kotlin/ranges/downTo|downTo]]</code> ===
-تعيد الدالة ‎<code>downTo()‎</code> مجالا متدرّجًا (progression) تنازليًا من القيمة التي استُدعيت عبرها وحتى القيمة الممرّرة. ينبغي أن تكون القيمة الممررة أصغر من القيمة التي استُدعيت عبرها الدالة، وإلّا ستعيد الدالة مجالا متدرجا فارغًا.
+تنشئ الدالة ‎<code>downTo()‎</code> مجالًا متدرجًا (progression) يبدًأ من القيمة القصوى التي استُدعيت معها وينحدر تنازليًّا حتى يصل إلى القيمة الممرّرة إليها.
 === <code>[[Kotlin/text/equals|equals]]</code> ===
-تعيد الدالة <code>equals()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] أو السلسلة النصية التي استُدعيت عبرها مساوية <nowiki/>[[Kotlin/Char/index|للحرف]] أو السلسلة النصية المُمرّرة إليها. في حال تمرير الوسيط <code>ignoreCase</code> وإعطائه القيمة <code>true</code> فإنّ الدالة لن تفرق بين الحروف الصغيرة والكبيرة. القيمة الابتدائية للوسيط <code>ignoreCase</code> هي<code>false</code>.
+تتحقق الدالة <code>equals()</code>‎ من تساوي محرفين أو سلسلتين نصيتين مع بعضهما بعضًا.
 === <code>[[Kotlin/text/isDefined|isDefined]]</code> ===
-تعيد الدالة <code>isDefined()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
+تتحقق الدالة <code>isDefined()</code>‎ إن كان <nowiki/>[[Kotlin/Char|المحرف]] (Unicode code point) الذي استٌدعيت معها مُعرّفًا في الترميز الموحَّد (Unicode) أم لا.
 === <code>[[Kotlin/text/isDigit|isDigit]]</code> ===
-تعيد الدالة <code>isDigit()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] الذي استٌدعيت عبره رقمًا.
+تتحقق الدالة <code>isDigit()</code>‎ إن كان <nowiki/>[[Kotlin/Char|المحرف]] الذي استٌدعيت معه رقمًا أم لا.
 === <code>[[Kotlin/text/isHighSurrogate|isHighSurrogate]]</code> ===
-تعيد الدالة <code>isHighSurrogate()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] الذي استٌدعيت عبره بديلًا علويًا لكود اليونيكود (Unicode high-surrogate code unit).
+تتحقق الدالة <code>isHighSurrogate()</code>‎ إن كان <nowiki/>[[Kotlin/Char|المحرف]] الذي استٌدعي معها بديلًا علويًا لعدد بتات الترميز الموحد (Unicode high-surrogate code unit).
 === <code>[[Kotlin/text/isISOControl|isISOControl]]</code> ===
-تعيد الدالة <code>isISOControl()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] الذي استٌدعيت عبره من حروف الضبط ISO ‎‎‏ ‎ISO control character)‎‎‎).
+تتحقق الدالة <code>isISOControl()</code>‎ إن كان <nowiki/>[[Kotlin/Char|المحرف]] الذي استٌدعي معها هو أحد محارف تحكمISO ‎‎‏ ‎ISO control character)‎‎‎).
 === <code>[[Kotlin/text/isIdentifierIgnorable|isIdentifierIgnorable]]</code> ===
-تعيد الدالة <code>isIdentifierIgnorable()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] الذي استٌدعيت عبره يجب أن يُهمل في مُعرِّفات جافا (Java identifier) أو اليونيكود.
+تتحقق الدالة <code>isIdentifierIgnorable()</code>‎ إن كان <nowiki/>[[Kotlin/Char|المحرف]] الذي استٌدعي معها محرفًا قابلًا للإهمال (ignorable character) في مُعرِّفات جافا (Java identifier) أو معرِّفات الترميز الموحَّد (Unicode identifier).
 === <code>[[Kotlin/text/isJavaIdentifierPart|isJavaIdentifierPart]]</code> ===
-تعيد الدالة <code>isJavaIdentifierPart()</code>‎ القيمة <code>true</code> في حال كان من الجائز أن يكون <nowiki/>[[Kotlin/Char/index|الحرف]] الذي استٌدعيت عبره جزءا من مُعرِّف جافا (Java identifier) بخلاف الحرف الأول من المُعرّف.
+تتحقق الدالة <code>isJavaIdentifierPart()</code>‎ إن كان من المحتمل أن يكون <nowiki/>[[Kotlin/Char|المحرف]] الذي استٌدعي معها جزءًا من مُعرِّف جافا (Java identifier) وليس المحرف الأول من المُعرّف.
 === <code>[[Kotlin/text/isJavaIdentifierStart|isJavaIdentifierStart]]</code> ===
-تعيد الدالة <code>isJavaIdentifierStart()</code>‎ القيمة <code>true</code> في حال كان من الجائز أن يكون <nowiki/>[[Kotlin/Char/index|الحرف]] الذي استٌدعيت عبره الحرف الأول من مُعرِّف جافا (Java identifier).
+تتحقق الدالة <code>isJavaIdentifierStart()</code>‎ إن كان يُسمَح أن يكون <nowiki/>[[Kotlin/Char|المحرف]] الذي استٌدعي معها المحرف الأول من مُعرِّف جافا (Java identifier).
 === <code>[[Kotlin/text/isLetter|isLetter]]</code> ===
-تعيد الدالة <code>isLetter()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] (character) الذي استٌدعيت عبره حرفًا أبجديًا.
+تتحقق الدالة <code>isLetter()</code>‎ إن كان <nowiki/>[[Kotlin/Char|المحرف]] (character) الذي استٌدعي معها حرفًا أبجديًا.
 === <code>[[Kotlin/text/isLetterOrDigit|isLetterOrDigit]]</code> ===
-تعيد الدالة <code>isLetterOrDigit()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] (character) الذي استٌدعيت عبره حرفًا أبجديًا أو رقمًا.
+تتحقق الدالة <code>isLetterOrDigit()</code>‎ إن كان <nowiki/>[[Kotlin/Char|المحرف]] (character) الذي استٌدعي معها حرفًا أبجديًا أو رقمًا.
 === <code>[[Kotlin/text/isLowSurrogate|isLowSurrogate]]</code> ===
-تعيد الدالة <code>isLowSurrogate()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] الذي استٌدعيت عبره بديلًا دنويا لكود اليونيكود (Unicode low-surrogate code unit).
+تتحقق الدالة <code>isLowSurrogate()</code>‎ إن كان <nowiki/>[[Kotlin/Char|المحرف]] الذي استٌدعي معها بديلًا سفليًّا لعدد بتات الترميز الموحد (Unicode low-surrogate code unit).
 === <code>[[Kotlin/text/isLowerCase|isLowerCase]]</code> ===
-تعيد الدالة <code>isLowerCase()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] (character) الذي استٌدعيت عبره حرفًا صغيرًا (lower case).
+تتحقق الدالة <code>isLowerCase()</code>‎ إن كان <nowiki/>[[Kotlin/Char|الحرف]] الذي استٌدعي معها حرفًا صغيرًا (lower case).
 === <code>[[Kotlin/text/isSurrogate|isSurrogate]]</code> ===
-تعيد الدالة <code>isSurrogate()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] الذي استٌدعيت عبره بديلًا لكود اليونيكود (Unicode surrogate code unit).
+تتحقق الدالة <code>isSurrogate()</code>‎ إن كان <nowiki/>[[Kotlin/Char|المحرف]] الذي استٌدعي معها بديلًا لعدد بتات الترميز الموحد (Unicode surrogate code unit).
 === <code>[[Kotlin/text/isTitleCase|isTitleCase]]</code> ===
-تعيد الدالة <code>isTitleCase()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] (character) الذي استٌدعيت عبره حرفًا عُنوانيًا (titlecase). هذه الحروف تكون عادة مكونة من حرفين ملتصقين، مثل <code>'ǅ'</code> أو <code>'ǋ'</code>.
+تتحقق الدالة <code>isTitleCase()</code>‎ إن كان <nowiki/>[[Kotlin/Char|المحرف]] الذي استٌدعي معها محرفًا عُنوانيًا (titlecase). تتكون هذه المحارف عادةً من محرفين ملتصقين، مثل <code>'ǅ'</code> أو <code>'ǋ'</code>، إذ يعاملان وكأنَّهما محرفٌ واحدٌ فقط.
 === <code>[[Kotlin/text/isUpperCase|isUpperCase]]</code> ===
-تعيد الدالة <code>isUpperCase()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] (character) الذي استٌدعيت عبره حرفًا كبيرا (upper case).
+تتحقق الدالة <code>isUpperCase()</code>‎ إن كان <nowiki/>[[Kotlin/Char|الحرف]] الذي استٌدعي معها حرفًا كبيرًا (upper case).
 === <code>[[Kotlin/text/isWhitespace|isWhitespace]]</code> ===
-تعيد الدالة <code>isWhitespace()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] (character) الذي استٌدعيت عبره مسافة بيضاء (whitespace).
+تتحقق الدالة <code>isWhitespace()</code>‎ إن كان <nowiki/>[[Kotlin/Char|المحرف]] الذي استٌدعي معها هو مسافة بيضاء (whitespace).
 === <code>[[Kotlin/text/plus|plus]]</code> ===
-تضم الدالة <code>plus()</code>‎ <nowiki/>[[Kotlin/Char/index|الحرف]] الذي استٌدعيت عبره إلى السلسلة النصية المُمرّرة إليها.
+تضيف الدالة <code>plus()</code>‎ <nowiki/>[[Kotlin/Char|الحرف]] الذي استٌدعي معها إلى بداية السلسلة النصية المُمرّرة إليها.
 === <code>[[Kotlin/text/toLowerCase|toLowerCase]]</code> ===
-تحوّل الدالة <code>toLowerCase()</code>‎ <nowiki/>[[Kotlin/Char/index|الحرف]] أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الصغيرة (lowercase).
+تحوّل الدالة <code>toLowerCase()</code>‎ <nowiki/>[[Kotlin/Char|المحرف]] أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف صغيرة (lowercase).
 === <code>[[Kotlin/text/toTitleCase|toTitleCase]]</code> ===
-تحوّل الدالة <code>toTitleCase()</code>‎ <nowiki/>[[Kotlin/Char/index|الحرف]] الذي استٌدعيت عبره إلى حرف عنواني (titlecase).
+تحوّل الدالة <code>toTitleCase()</code>‎ <nowiki/>[[Kotlin/Char|المحرف]] الذي استٌدعي معها إلى محرف عنواني (titlecase). تتكون المحارف العنوانية عادةً من محرفين ملتصقين، مثل <code>'ǅ'</code> أو <code>'ǋ'</code>، إذ يعاملان وكأنَّهما محرفٌ واحدٌ فقط.
 === <code>[[Kotlin/text/toUpperCase|toUpperCase]]</code> ===
-تحوّل الدالة <code>toUpperCase()</code>‎ <nowiki/>[[Kotlin/Char/index|الحرف]] أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).
+تحوّل الدالة <code>toUpperCase()</code>‎ <nowiki/>[[Kotlin/Char|المحرف]] أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف كبيرة (uppercase).
 === <code>[[Kotlin/ranges/until|until]]</code> ===
-تعيد الدالة ‎<code>until()‎</code> مجالا (range) تصاعديًا من القيمة التي استُدعيت عبرها وحتى القيمة الممرّرة (القيمة المُمرّرة مُستثناة).
+تنشئ الدالة ‎<code>until()‎</code> مجالًا (range) تصاعديًا يبدأ القيمة التي استُدعيت معها وحتى القيمة الممرّرة إليها (لا تدخل هذه القيمة ضمن المجال).
+== مصادر ==
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char/index.html صفحة الصنف Char في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Classes]]
+[[تصنيف:Kotlin Class]]
 [[تصنيف:Kotlin Char]]