الصنف Char في Kotlin
يمثل الصنف 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). تتكون هذه المحارف عادةً من محرفين ملتصقين، مثل 'Dž' أو 'Nj'، إذ يعاملان وكأنَّهما محرفٌ واحدٌ فقط.
isUpperCase
تتحقق الدالة isUpperCase() إن كان الحرف الذي استٌدعي معها حرفًا كبيرًا (upper case).
isWhitespace
تتحقق الدالة isWhitespace() إن كان المحرف الذي استٌدعي معها هو مسافة بيضاء (whitespace).
plus
تضيف الدالة plus() الحرف الذي استٌدعي معها إلى بداية السلسلة النصية المُمرّرة إليها.
toLowerCase
تحوّل الدالة toLowerCase() المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف صغيرة (lowercase).
toTitleCase
تحوّل الدالة toTitleCase() المحرف الذي استٌدعي معها إلى محرف عنواني (titlecase). تتكون المحارف العنوانية عادةً من محرفين ملتصقين، مثل 'Dž' أو 'Nj'، إذ يعاملان وكأنَّهما محرفٌ واحدٌ فقط.
toUpperCase
تحوّل الدالة toUpperCase() المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف كبيرة (uppercase).
until
تنشئ الدالة until() مجالًا (range) تصاعديًا يبدأ القيمة التي استُدعيت معها وحتى القيمة الممرّرة إليها (لا تدخل هذه القيمة ضمن المجال).