النصوص في Kotlin

دول للاستعمال مع النصوص والتعابير النمطية.

الأنواع

`MatchGroup`

تمثل نتيجة من مجموعة مطابقة داخل MatchResult الخاصة بالصنف Regex.

`MatchGroupCollection`

تمثل MatchGroupCollection مجموعة من الفئات المرصودة (captured groups) في إحدى مطابقات تعبير نمطي ما.

`MatchNamedGroupCollection`

تمدد MatchGroupCollection عبر تقديم طريقة للحصول على الفئات المُطابَقة (matched groups) بأسمائها، عندما تكون regex مدعومة.

`Regex`

يمثل تعبيرًا نمطيا قابلا للتعديل (immutable regular expression).

`RegexOption`

يوفّر قيما مُرقّمة (enumeration values) لاستخدامها في تعيين خيارات التعابير النمطية.

`Typography`

تعرّف أسماء لرموز اليونيكود المستخدمة في الطباعة الخاصة.

أسماء الأنواع (Type Aliases)

تمديدات لأصناف خارجية

الخاصيات

`category`

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

`directionality`

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

`indices`

تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) لسلسلة الحروف التي استُدعيت عبرها.

`lastIndex`

تُستخدَم هذه الخاصيّة للحصول على فهرس الحرف الأخير في سلسلة الحروف التي استُدعيت عبرها، أو تعيد ‎-1 إن كانت فارغة.

`size`

هذه الخاصية صارت مُتجاوزة، استخدم الخاصية length بدلًا منها.

الدوال

`Regex_0`

هذه الدالة صارت مُتجاوزة. إذ تنشئ تعبيرًا نمطيًا (regular expression) انطلاقًا من السلسلة النصية المُمرّرة.

`Regex_1`

هذه الدالة صارت مُتجاوزة. إذ تنشئ تعبيرًا نمطيًا (regular expression) انطلاقًا من السلسلة النصية المُمرّرة.

`String`

يختلف سلوك الدالة String()‎ بحسب نوع وعدد الوسائط المُمررة، انظر فقرة البنية العامة.

`all`

تعيد الدالة all()‎ القيمة true إن كانت كل الحروف تحقق الشرط المنطقي المُمرّر predicate.

`any`

تعيد الدالة any()‎ القيمة true إن كان هناك حرف واحد على الأقل يحقق الشرط المنطقي المُمرّر predicate.

`append`

تضم الدالة append()‎ الوسائط المُمرّرة إلى الكائن الذي استُدعيت عبره، والذي ينبغي أن يكون من الصنف Appendable.

`asIterable`

تنشئ الدالة asIterable()‎ كائنًا من الصنف Iterable والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.

`asSequence`

تنشئ الدالة asSequence()‎ كائنًا من الصنف Sequence والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.

`associate`

تعيد الدالة associate()‎ قاموسًا (map) يحتوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير عناصر سلسلة الحروف التي استُدعيت عبرها.

`associateBy`

تعيد الدالة associateBy()‎ قاموسًا (map) يحتوي عناصر سلسلة الحروف التي استُدعيت عبرها مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالة keySelector.

تعيد الدالة associateByTo()‎ قاموسا متغيرا (mutable map) يحتوي أزواجًا من "مفتاح/قيمة"، إذ القيمة هي عناصر سلسلة الحروف التي استُدعيت عبرها، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة keySelector.

`associateTo`

تملأ الدالة associateTo()‎ القاموس المتغير destination بأزواج من "مفتاح/قيمة"، حيث القيمة هي عناصر سلسلة الحروف التي استُدعيت عبرها، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة transform.

`buildString`

تبني الدالة buildString()‎ سلسلة نصية عبر ملأ الكائن من نوع StringBuilder المُنشأ حديثَا باستخدام الدالة المُمرّرة builderAction‎ ثم تُحولها إلى سلسلة نصية. في حال تمرير وسيط capacity من نوع Int فإنّ الكائن StringBuilder سيأخذ قيمه الابتدائية انطلاقا منcapacity.

`capitalize`

تعيد الدالة capitalize()‎ نسخة من السلسلة النصية التي استُدعيت عبرها، مع جعل الحرف الأول كبيرًا (uppercase).

`charset`

تعيد الدالة charset()‎ مجموعة المحارف المُسمّاة (named charset) ذات الاسم المُمرّر charsetName.

`chunked`

تُقسّم الدالة chunked()‎ سلسلة الحروف التي استُدعيت عبرها إلى لوائح تحتوي سلاسل نصية، بحيث لا يتجاوز تعدادها العدد المُمرّر size.

`chunkedSequence`

تُقسّم الدالة chunkedSequence()‎ سلسلة الحروف التي استُدعيت عبرها إلى سلسلاتتحتوي سلاسل نصية، بحيث لا يتجاوز تعدادها العدد المُمرّرsize.

`codePointAt`

تعيد الدالة codePointAt()‎ كود اليونيكود (Unicode code point) للحرف الموجود في الفهرس المُحدّد.

`codePointBefore`

تعيد الدالة codePointBefore()‎ كود اليونيكود (Unicode code point) للحرف الموجود قبل الفهرس المُحدّد.

`codePointCount`

تعيد الدالة codePointCount()‎ عدد أكواد اليونيكود (Unicode code point) في المجال المُحدّد من النص.

`commonPrefixWith`

تعيد الدالة commonPrefixWith()‎ أكبر سابقة (prefix) مُشتركة بين سلسلة الحروف التي استُدعيت عبرها وسلسلة الحروف المُمرّرة، وفي حال إعطاء القيمة true للوسيط ignoreCase فستتجاهل الدالة حالة الحروف (لن تفرّق بين الحروف الكبيرة والصغيرة). الدالة أيضًا لا تُقسّم الأزواج البديلة (surrogate pairs)، وإن لم تكن بينهما سابقة مشتركة فستعيد سلسلة نصية فارغة.

`commonSuffixWith`

تعيد الدالة commonSuffixWith()‎ أكبر لاحقة (suffix) مُشتركة بين سلسلة الحروف التي استُدعيت عبرها وسلسلة الحروف المُمرّرة، وفي حال إعطاء القيمة true للوسيط ignoreCase فستتجاهل الدالة حالة الحروف (لن تفرّق بين الحروف الكبيرة والصغيرة). الدالة أيضًا لا تُقسّم الأزواج البديلة (surrogate pairs)، وإن لم تكن بينهما لاحقة مشتركة فستعيد سلسلة نصية فارغة.

`compareTo`

تقارن الدالة compareTo()‎ بين سلسلتين نصيتين، مع إمكانية تجاهل حالة الأحرف عبر إعطاء القيمة true للوسيط ignoreCase.

`concat`

تضم الدالة concat()‎ السلسلة النصية التي استُدعيت عبرها إلى السلسلة النصية المُمرّرة وتعيد السلسلة النصية الناتجة.

`contains`

تعيد الدالة contains()‎ القيمة true إن كانت سلسلة الحروف التي استُدعيت عبرها تحتوي الحرف أو سلسلة الحروف المُمرّرة. الوسيطignoreCase يحدد ما إذا كانت الدالة ستتجاهل حالة الحروف.