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