الفرق بين المراجعتين ل"Kotlin/kotlin.text"
جميل-بيلوني (نقاش | مساهمات) |
|||
| سطر 1: | سطر 1: | ||
| − | <nowiki/><noinclude>{{DISPLAYTITLE: النصوص في Kotlin}}</noinclude> | + | تستعمل ال<nowiki/><noinclude>{{DISPLAYTITLE: النصوص في Kotlin}}</noinclude>دوال التالية في التعامل مع النصوص و<nowiki/>[[Kotlin/kotlin.text/Regex/index|التعابير النمطية]]. |
| − | |||
==الأنواع== | ==الأنواع== | ||
===<code>[[Kotlin/kotlin.text/Appendable/index|Appendable]]</code>=== | ===<code>[[Kotlin/kotlin.text/Appendable/index|Appendable]]</code>=== | ||
| − | ===<code>[[Kotlin/kotlin.text/CharCategory | + | ===<code>[[Kotlin/kotlin.text/CharCategory|CharCategory]]</code>=== |
===<code>[[Kotlin/kotlin.text/CharDirectionality/index|CharDirectionality]]</code>=== | ===<code>[[Kotlin/kotlin.text/CharDirectionality/index|CharDirectionality]]</code>=== | ||
===<code>[[Kotlin/kotlin.text/Charsets/index|Charsets]]</code>=== | ===<code>[[Kotlin/kotlin.text/Charsets/index|Charsets]]</code>=== | ||
===<code>[[Kotlin/kotlin.text/MatchGroup/index|MatchGroup]]</code>=== | ===<code>[[Kotlin/kotlin.text/MatchGroup/index|MatchGroup]]</code>=== | ||
| − | + | يمثل الصنف <code>MatchGroup</code> النتائج التي نحصل عليها من مجموعة واحدة ضمن <code>[[Kotlin/kotlin.text/MatchResult/index|MatchResult]]</code> الخاصة بالصنف <code>[[Kotlin/kotlin.text/Regex/index|Regex]]</code>. | |
===<code>[[Kotlin/kotlin.text/MatchGroupCollection/index|MatchGroupCollection]]</code>=== | ===<code>[[Kotlin/kotlin.text/MatchGroupCollection/index|MatchGroupCollection]]</code>=== | ||
| − | + | تمثل الواجهة <code>MatchGroupCollection</code> مجموعةً (collection) من الفئات المرصودة (captured groups) عند إجراء مطابقة واحدة <nowiki/>[[Kotlin/kotlin.text/Regex/index|لتعبير نمطي]] ما. | |
===<code>[[Kotlin/kotlin.text/MatchNamedGroupCollection/index|MatchNamedGroupCollection]]</code>=== | ===<code>[[Kotlin/kotlin.text/MatchNamedGroupCollection/index|MatchNamedGroupCollection]]</code>=== | ||
| − | + | توسع هذه الواجهة الصنف <code>[[Kotlin/kotlin.text/MatchGroupCollection|MatchGroupCollection]]</code> عبر تعريف طريقةٍ لجلب المجموعات المتطابقة (matched groups) عن طريق أسمائها عندما يدعم <code>regex</code> ذلك. | |
===<code>[[Kotlin/kotlin.text/MatchResult/index|MatchResult]]</code>=== | ===<code>[[Kotlin/kotlin.text/MatchResult/index|MatchResult]]</code>=== | ||
| − | تمثل | + | تمثل الواجهة <code>MatchResult</code> نتائج مطابقة واحدة <nowiki/>[[Kotlin/kotlin.text/Regex/index|لتعبير نمطي]]. |
===<code>[[Kotlin/kotlin.text/Regex/index|Regex]]</code>=== | ===<code>[[Kotlin/kotlin.text/Regex/index|Regex]]</code>=== | ||
| − | + | يمثل الصنف <code>Regex</code> <nowiki/>[[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيا]] قابلًا للتعديل (immutable regular expression). إن أردت الاطلاع على المزيد من المعلومات المتعلقة بصياغة النمط (pattern)، انتقل إلى صفحة الصنف<code>[[Kotlin/kotlin.text/java.util.regex.Pattern/index|Pattern]]</code>. | |
===<code>[[Kotlin/kotlin.text/RegexOption/index|RegexOption]]</code>=== | ===<code>[[Kotlin/kotlin.text/RegexOption/index|RegexOption]]</code>=== | ||
| − | يوفّر | + | يوفّر الصنف <code>RegexOption</code> قيمًا قابلةً للعد (enumeration values) لاستخدامها في تعيين خيارات <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعابير النمطية]]. |
| − | ===<code>[[Kotlin/kotlin.text/StringBuilder | + | ===<code>[[Kotlin/kotlin.text/StringBuilder|StringBuilder]]</code>=== |
===<code>[[Kotlin/kotlin.text/Typography/index|Typography]]</code>=== | ===<code>[[Kotlin/kotlin.text/Typography/index|Typography]]</code>=== | ||
تعرّف أسماء لرموز اليونيكود المستخدمة في الطباعة الخاصة. | تعرّف أسماء لرموز اليونيكود المستخدمة في الطباعة الخاصة. | ||
| − | ==أسماء | + | ==أسماء بديلة للأنواع (Type Aliases)== |
===<code>[[Kotlin/kotlin.text/Appendable/index|Appendable]]</code>=== | ===<code>[[Kotlin/kotlin.text/Appendable/index|Appendable]]</code>=== | ||
===<code>[[Kotlin/kotlin.text/StringBuilder/index|StringBuilder]]</code>=== | ===<code>[[Kotlin/kotlin.text/StringBuilder/index|StringBuilder]]</code>=== | ||
| سطر 42: | سطر 41: | ||
==الخاصيات== | ==الخاصيات== | ||
===<code>[[Kotlin/kotlin.text/category|category]]</code>=== | ===<code>[[Kotlin/kotlin.text/category|category]]</code>=== | ||
| − | + | تمثل الخاصية <code>category</code> فئة المحرف العامة (character's general category). | |
===<code>[[Kotlin/kotlin.text/directionality|directionality]]</code>=== | ===<code>[[Kotlin/kotlin.text/directionality|directionality]]</code>=== | ||
| − | + | تمثل الخاصية <code>Char.directionality</code> خاصية الاتجاه في الترميز الموحد (Unicode directionality property) للمحرف الذي استُدعي معها. | |
===<code>[[Kotlin/kotlin.text/indices|indices]]</code>=== | ===<code>[[Kotlin/kotlin.text/indices|indices]]</code>=== | ||
| − | + | تمثل الخاصيّة <code>CharSequence.indices</code> مجال فهارس المحارف الصالحة <nowiki/>[[Kotlin/CharSequence|لسلسلة المحارف]] التي استُدعيت معها. | |
===<code>[[Kotlin/kotlin.text/lastIndex|lastIndex]]</code>=== | ===<code>[[Kotlin/kotlin.text/lastIndex|lastIndex]]</code>=== | ||
| − | + | تمثل الخاصيّة <code>CharSequence.lastIndex</code> فهرس المحرف الأخير في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها. | |
===<code>[[Kotlin/kotlin.text/size|size]]</code>=== | ===<code>[[Kotlin/kotlin.text/size|size]]</code>=== | ||
| − | + | أصبحت الخاصية <code>CharSequence.size</code> مهملة، لذا استخدم الخاصية <nowiki/>[[Kotlin/CharSequence/length|<code>CharSequence.length</code>]] بدلًا منها. | |
==الدوال== | ==الدوال== | ||
مراجعة 14:51، 9 سبتمبر 2018
تستعمل الدوال التالية في التعامل مع النصوص والتعابير النمطية.
الأنواع
Appendable
CharCategory
CharDirectionality
Charsets
MatchGroup
يمثل الصنف MatchGroup النتائج التي نحصل عليها من مجموعة واحدة ضمن MatchResult الخاصة بالصنف Regex.
MatchGroupCollection
تمثل الواجهة MatchGroupCollection مجموعةً (collection) من الفئات المرصودة (captured groups) عند إجراء مطابقة واحدة لتعبير نمطي ما.
MatchNamedGroupCollection
توسع هذه الواجهة الصنف MatchGroupCollection عبر تعريف طريقةٍ لجلب المجموعات المتطابقة (matched groups) عن طريق أسمائها عندما يدعم regex ذلك.
MatchResult
تمثل الواجهة MatchResult نتائج مطابقة واحدة لتعبير نمطي.
Regex
يمثل الصنف Regex تعبيرًا نمطيا قابلًا للتعديل (immutable regular expression). إن أردت الاطلاع على المزيد من المعلومات المتعلقة بصياغة النمط (pattern)، انتقل إلى صفحة الصنفPattern.
RegexOption
يوفّر الصنف RegexOption قيمًا قابلةً للعد (enumeration values) لاستخدامها في تعيين خيارات التعابير النمطية.
StringBuilder
Typography
تعرّف أسماء لرموز اليونيكود المستخدمة في الطباعة الخاصة.
أسماء بديلة للأنواع (Type Aliases)
Appendable
StringBuilder
تمديدات لأصناف خارجية
java.lang.Appendable
تمديد للصنف java.lang.Appendable.
java.lang.StringBuilder
java.util.regex.Pattern
تمديد للصنف java.util.regex.Pattern.
الخاصيات
category
تمثل الخاصية category فئة المحرف العامة (character's general category).
directionality
تمثل الخاصية Char.directionality خاصية الاتجاه في الترميز الموحد (Unicode directionality property) للمحرف الذي استُدعي معها.
indices
تمثل الخاصيّة CharSequence.indices مجال فهارس المحارف الصالحة لسلسلة المحارف التي استُدعيت معها.
lastIndex
تمثل الخاصيّة CharSequence.lastIndex فهرس المحرف الأخير في سلسلة المحارف التي استُدعيت معها.
size
أصبحت الخاصية CharSequence.size مهملة، لذا استخدم الخاصية CharSequence.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
تعيد الدالة 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 يحدد ما إذا كانت الدالة ستتجاهل حالة الحروف.
contentEquals
تعيد الدالة contentEquals() القيمة true إن كانت السلسلة النصية التي استُدعيت عبرها تساوي سلسلة الحروف أو الكائن (StringBuffer) المُمرّر.
count
تعيد الدالة count() عدد حروف السلسلة النصية التي استُدعيت عبرها، وفي حال تمرير دالة منطقية predicate فستعيد عدد الحروف التي تحقق تلك الدالة المنطقية.
decapitalize
تعيد الدالة decapitalize() نسخة من السلسلة النصية التي استُدعيت عبرها، مع جعل الحرف الأول صغيرا (lowercase).
drop
تعيد الدالة drop() جزءًا من السلسلة النصية أو سلسلة الحروف التي استُدعيت عبرها مع حذف أول n حرفًا.
dropLast
تعيد الدالة dropLast() جزءًا من السلسلة النصية أو سلسلة الحروف التي استُدعيت عبرها مع حذف آخر n حرفًا.
dropLastWhile
تعيد الدالة dropLastWhile() جزءًا من السلسلة النصية أو سلسلة الحروف التي استُدعيت عبرها مع حذف الحروف الأخيرة التي تحقق الشرط المنطقي المُمرّر predicate.
dropWhile
تعيد الدالة dropWhile() جزءًا من السلسلة النصية أو سلسلة الحروف التي استُدعيت عبرها مع حذف الحروف الأولى التي تحقق الشرط المنطقي المُمرّرpredicate.
elementAt
تعيد الدالة elementAt() الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناء IndexOutOfBoundsException.
elementAtOrElse
تعيد الدالة elementAtOrElse() الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، وفي حال كان الفهرس خارج الحدود فستعيد ناتج تمرير ذلك الفهرس إلى الدالة المُمررة defaultValue.
elementAtOrNull
تعيد الدالة elementAtOrNull() الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، وفي حال كان الفهرس خارج الحدود فستعيد null.
endsWith
تعيد الدالة endsWith() القيمة true إن كانت سلسلة الحروف أو السلسلة النصية التي استُدعيت عبرها تنتهي بالحرف أو اللاحقة المُمرّرة. الوسيطignoreCase يحدد ما إذا كانت الدالة ستتجاهل حالة الحروف.
equals
تعيد الدالة equals() القيمة true في حال كان الحرف أو السلسلة النصية التي استُدعيت عبرها مساوية للحرف أو السلسلة النصية المُمرّرة إليها. في حال تمرير الوسيط ignoreCase وإعطائه القيمة true فإنّ الدالة لن تفرق بين الحروف الصغيرة والكبيرة. القيمة الابتدائية للوسيط ignoreCase هيfalse.
filter
تعيد الدالة filter() سلسلة حروف أو سلسلة نصية تحتوي الحروف من سلسلة الحروف أو السلسلة النصية التي استُدعيت عبرها والتي تحقق الشرط المنطقي المُمرّر predicate.
filterIndexed
تعيد الدالة filterIndexed() كل الحروف من سلسلة الحروف التي استُدعيت عبرها والتي تحقق الشرط المنطقي. يمرَّر فهرس كل عنصر وقيمته إلى الدالة predicate() ثم تعيد بدورها قيمة منطقيَّة.
filterIndexedTo
تضيف الدالة filterIndexedTo() كل الحروف من سلسلة الحروف التي استُدعيت عبرها والتي تحقق الشرط المنطقي predicate إلى الوسيط المُمرّر destination. يمرَّر فهرس كل عنصر وقيمته إلى الدالة predicate() ثم تعيد بدورها قيمة منطقيَّة.
filterNot
تعيد الدالة filterNot() سلسلة حروف أو سلسلة نصية تحتوي الحروف من سلسلة الحروف أو السلسلة النصية التي استُدعيت عبرها والتي لا تحقق الشرط المنطقي المُمرّر predicate.
filterNotTo
تضيف الدالة filterNotTo() كل الحروف من سلسلة الحروف التي استُدعيت عبرها والتي لا تحقق الشرط المنطقي predicate إلى الوسيط المُمرّرdestination.
filterTo
تضيف الدالة filterTo() كل الحروف من سلسلة الحروف التي استُدعيت عبرها والتي تحقق الشرط المنطقي predicate إلى الوسيط المُمرّرdestination.
find
تعيد الدالة find() أول حرف من سلسلة الحروف التي استُدعيت عبرها والذي يحقق الشرط المنطقي predicate، أو تعيد null إن لم يوجد أي تطابق.
findAnyOf
تبحث الدالة findAnyOf() عن أول ظهور لأي واحدة من السلاسل النصية الموجودة في الوسيط المُمرّر strings في سلسلة الحروف التي استُدعيت عبرها بداية من الفهرس startIndex، وفي حال إعطاء القيمة true للوسيط ignoreCase فستتجاهل الدالة حالة الحروف.
findLast
تعيد الدالة findLast() آخر حرف من سلسلة الحروف التي استُدعيت عبرها والذي يحقق الشرط المنطقي predicate. أو تعيد null إن لم يوجد أي تطابق.
findLastAnyOf
تبحث الدالة findLastAnyOf() عن آخر ظهور لأي واحدة من السلاسل النصية الموجودة في الوسيط المُمرّر strings في سلسلة الحروف التي استُدعيت عبرها بداية من الفهرس startIndex، وفي حال إعطاء القيمة true للوسيط ignoreCase فستتجاهل الدالة حالة الحروف.
first
تعيد الدالة first() الحرف الأول من سلسلة الحروف التي استُدعيت عبرها، وفي حال تمرير دالة منطقية predicate كوسيط فستعيد الحرف الأول الذي يحقق الشرط المنطقي predicate.
firstOrNull
تعيد الدالة firstOrNull() الحرف الأول من سلسلة الحروف التي استُدعيت عبرها، وفي حال تمرير دالة منطقية predicate كوسيط فستعيد الحرفالأول الذي يحقق الشرط المنطقي predicate.
flatMap
تعيد الدالةflatMap() لائحة تضم ناتج تطبيق الدالة transform() المُمرّرة إليها على عناصر سلسلة الحروف التي استُدعيت عبرها.
flatMapTo
تضيف الدالةflatMapTo() إلى اللائحة المُتغيرة (MutableCollection) destinationالمُمرّرة إليها ناتج تطبيق الدالة transform() على عناصر سلسلة الحروف التي استُدعيت عبرها.
fold
تُراكِم الدالةfold() القيم بدءًا من القيمة المُمرّرة initial وتطبّق العملية operation من اليسار إلى اليمين على القيمة الراهنة وعلى الحرف الموالي في سلسلة الحروف التي استُدعيت عبرها. ثم تُعيد القيمة النهائية.
foldIndexed
تُراكِم الدالةfoldIndexed() القيم بدءًا من القيمة المُمرّرة initial وتطبّق العملية operation من اليسار إلى اليمين على القيمة الراهنة وعلى الحرف الموالي في سلسلة الحروف التي استُدعيت عبرها وكذلك فهرسه. ثم تُعيد القيمة النهائية.
foldRight
تُراكِم الدالةfoldRight() القيم بدءًا من القيمة المُمرّرة initial وتطبّق العملية operation من اليمين إلى اليسار على القيمة الراهنة وعلى الحرف الموالي في سلسلة الحروف التي استُدعيت عبرها. ثم تُعيد القيمة النهائية.
foldRightIndexed
تُراكِم الدالةfoldRightIndexed() القيم بدءًا من القيمة المُمرّرة initial وتطبّق العملية operation من اليمين إلى اليسار على القيمة الراهنة وعلى الحرف الموالي في سلسلة الحروف التي استُدعيت عبرها وكذلك فهرسه. ثم تُعيد القيمة النهائية.
forEach
تنفّذ الدالةُforEach() الدالةَ المُمرّرة action على عناصر سلسلة الحروف التي استُدعيت عبرها.
forEachIndexed
تنفّذ الدالةُforEachIndexed() الدالةَ المُمرّرة action على عناصر سلسلة الحروف التي استُدعيت عبرها وعلى فهارسها.
format
يختلف سلوك حسب نوع وعدد الوسائط المُمرّرة إليها (انظر فقرة البنية العامة).
get
تعيد الدالةget() كائنا من النوع MatchGroup إن كانت المجموعة التي تحمل الإسم المُمرّر name مطابقَة، وإلا فستعيد null. المجموعات مفهرسة من 1 وحتى عدد المجموعات في التعبير النمطي، المجموعة ذات الفهرس 0 تقابل المطابقة الكلية.
getOrElse
تُعيد الدالةgetOrElse() الحرف الموجود عند الفهرس المُمرّر index في سلسلة الحروف التي استُدعيت عبرها، أو ناتج استدعاء الدالة المُمررة defaultValue على ذلك الفهرس إن كان خارج الحدود.
getOrNull
تُعيد الدالةgetOrNull() الحرف الموجود عند الفهرس المُمرّر index في سلسلة الحروف التي استُدعيت عبرها، أو القيمة null إن كان ذلك الفهرس خارج الحدود.
groupBy
تعيد الدالةgroupBy() قاموسًا يُجمّع حروف سلسلة الحروف التي استُدعيت عبرها حيث مفاتيحه تعيدها الدالة المُمرّرة keySelector وقيمه لوائحُ تضم عناصر سلسلة الحروف (أو ناتج تمرير عناصرها على الدالة valueTransform في حال تمريرها).
groupByTo
تجمّع الدالةgroupByTo() عناصر سلسلة الحروف التي استُدعيت عبرها وتضيفها إلى القاموس المُمرّر destination حيث مفاتيحه تعيدها الدالة الممرّرة keySelector() مُطبّقة على كل عناصر سلسلة الحروف، وقيمُه لوائح تضم العناصر المقابلة، وفي حال تمرير معامل ثالث valueTransform فإنّ القيم ستكون لوائح تضم ناتج تطبيق الدالة valueTransform على العناصر المقابلة . ثم تعيد القاموسdestination.
groupingBy
تُنشئ الدالةgroupingBy() كائنًا من النوع Grouping من سلسلة الحروف التي استُدعيت عبرها لاستخدامه لاحقًا مع عمليات المجموعات (group-and-fold operations)، وذلك باستخدام الدالة المُمرّرة keySelector لاستخلاص مفتاح من كل عنصر .
hasSurrogatePairAt
تعيد الدالةhasSurrogatePairAt() القيمة true إن كان لدى سلسلة الحروف التي استُدعيت عبرها زوج يونيكود بديل (Unicode surrogate pair) عند الفهرس المُحدّد.
indexOf
تعيد الدالة indexOf() فهرس أول ظهور للحرف أو السلسلة النصية المُمرّرة إليها في سلسلة الحروف التي استُدعيت عبرها بداية من الفهرس المُمرّرstartIndex، في حال كان ذلك الحرف غير موجود فستعيد العدد -1.
indexOfAny
تعيد الدالة indexOfAny() فهرس أول ظهور لأيّ من الحروف أو السلاسل النصية الواردة في الوسيط المُمرّر (chars أو strings)،
indexOfFirst
تعيد الدالة indexOfFirst() فهرس ظهور أول حرف في سلسلة الحروف التي استُدعيت عبرها والذي يحقق الشرط المنطقي predicate، وفي حال كان ذلك الحرف غير موجود فستعيد العدد -1.
indexOfLast
تعيد الدالة indexOfLast() فهرس ظهور آخر حرف في سلسلة الحروف التي استُدعيت عبرها والذي يحقق الشرط المنطقي predicate، وفي حال كان ذلك الحرف غير موجود فستعيد العدد -1.
intern
تعيد الدالة intern() تمثيلا قانونيا للسلسلة النصية التي استُدعيت عبرها.
isBlank
تعيد الدالة isBlank() القيمة true في حال كانت سلسلة الحروف التي استٌدعيت عبرها فارغة أو مكونة حصريا من المسافات البيضاء (whitespace characters).
isDefined
تعيد الدالة isDefined() القيمة true في حال كان كود الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
isDigit
تعيد الدالة isDigit() القيمة true في حال كان الحرف الذي استٌدعيت عبره رقمًا.
isEmpty
تعيد الدالة isEmpty() القيمة true في حال كانت سلسلة الحروف التي استٌدعيت عبرها فارغة.
isHighSurrogate
تعيد الدالة isHighSurrogate() القيمة true في حال كان الحرف الذي استٌدعيت عبره بديلًا علويًا (Unicode high-surrogate code unit).
isISOControl
تعيد الدالة isISOControl() القيمة true في حال كان الحرف الذي استٌدعيت عبره من حروف الضبط ISO ISO control character)).
isIdentifierIgnorable
تعيد الدالة isIdentifierIgnorable() القيمة true في حال كان الحرف الذي استٌدعيت عبره يجب أن يُهمل في مُعرِّفات جافا (Java identifier) أو اليونيكود.
isJavaIdentifierPart
تعيد الدالة isJavaIdentifierPart() القيمة true في حال كان من الجائز أن يكون الحرف الذي استٌدعيت عبره جزءا من مُعرِّف جافا (Java identifier) بخلاف الحرف الأول من المُعرّف.
isJavaIdentifierStart
تعيد الدالة isJavaIdentifierStart() القيمة true في حال كان من الجائز أن يكون الحرف الذي استٌدعيت عبره الحرف الأول من مُعرِّف جافا (Java identifier).
isLetter
تعيد الدالة isLetter() القيمة true في حال كان الحرف (character) الذي استٌدعيت عبره حرفًا أبجديًا.
isLetterOrDigit
تعيد الدالة isLetterOrDigit() القيمة true في حال كان الحرف (character) الذي استٌدعيت عبره حرفًا أبجديًا أو رقمًا.
isLowSurrogate
تعيد الدالة isLowSurrogate() القيمة true في حال كان الحرف الذي استٌدعيت عبره بديلًا دنويا لكود اليونيكود (Unicode low-surrogate code unit).
isLowerCase
تعيد الدالة isLowerCase() القيمة true في حال كان الحرف (character) الذي استٌدعيت عبره حرفًا صغيرًا (lower case).
isNotBlank
تعيد الدالة isNotBlank() القيمة true في حال كانت سلسلة الحروف التي استٌدعيت عبرها غير فارغة و تحتوي على الأقل على حرف واحد لا يساوي المسافة البيضاء (whitespace character).
isNotEmpty
تعيد الدالة isNotEmpty() القيمة true في حال كانت سلسلة الحروف التي استٌدعيت عبرها غير فارغة.
isNullOrBlank
تعيد الدالة isNullOrBlank() القيمة true في حال كانت سلسلة الحروف التي استٌدعيت عبرها تساوي null أو تتكوّن حصريا من مسافات بيضاء (whitespace characters).
isNullOrEmpty
تعيد الدالة isNullOrEmpty() القيمة true في حال كانت سلسلة الحروف التي استٌدعيت عبرها تساوي null أو فارغة.
isSurrogate
تعيد الدالة isSurrogate() القيمة true في حال كان الحرف الذي استٌدعيت عبره بديلًا لكود اليونيكود (Unicode surrogate code unit).
isTitleCase
تعيد الدالة isLetter() القيمة true في حال كان الحرف (character) الذي استٌدعيت عبره حرفًا عنوانيًا (titlecase character).
isUpperCase
تعيد الدالة isUpperCase() القيمة true في حال كان الحرف (character) الذي استٌدعيت عبره حرفًا كبيرا (upper case).
isWhitespace
تعيد الدالة isWhitespace() القيمة true في حال كان الحرف (character) الذي استٌدعيت عبره مسافة بيضاء (whitespace).
iterator
يعيد التابع iterator() عنصرًا تكراريًّا (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر سلسلة الحروف التي استٌدعيت عبرها.
last
تعيد الدالة last() آخر حروف في سلسلة الحروف التي استٌدعيت عبرها، وفي حال تمرير شرط منطقي فستعيد آخر حرف يحقق ذلك الشرط.
lastIndexOf
تعيد الدالة lastIndexOf() فهرس آخر ظهور للحرف أو السلسلة النصية المُمرّرة إليها في سلسلة الحروف التي استُدعيت عبرها بداية من الفهرس المُمرّرstartIndex، في حال كان ذلك الحرف غير موجود فستعيد العدد -1.
lastIndexOfAny
تعيد الدالة lastIndexOfAny() فهرس آخر ظهور لأيّ من الحروف أو السلاسل النصية الواردة في الوسيط المُمرّر (chars أو strings)،
lastOrNull
تعيد الدالة lastOrNull() الحرف الأخير من سلسلة الحروف التي استُدعيت عبرها، وفي حال تمرير دالة منطقية predicate كوسيط فستعيد الحرفالأخير الذي يحقق الشرط المنطقي predicate.
lineSequence
تقسّم الدالة lineSequence() سلسلة الحروف التي استٌدعيت عبرها إلى سلسلة مكونة من سطور مفصولة بأيٍّ من سلاسل الحروف التالية CRLF أو LFأو CR.
lines
تقسّم الدالة lines() سلسلة الحروف التي استٌدعيت عبرها إلى لائحة مكونة من سطور مفصولة بأيٍّ من سلاسل الحروف التالية CRLF أو LF أو CR.
map
تعيد الدالة map() لائحة مكونة من نتائج تطبيق الدالة transform المُمرّرة على عناصر سلسلة الحروف التي استٌدعيت عبرها.
mapIndexed
تعيد الدالة mapIndexed() لائحة مكونة من نتائج تطبيق الدالة transform المُمرّرة على عناصر سلسلة الحروف التي استٌدعيت عبرها وعلى فهارسها.
mapIndexedNotNull
تعيد الدالة mapIndexedNotNull() لائحة مكونة من النتائج غير المعدومة (non-nul) لتطبيق الدالة transform المُمرّرة على عناصر سلسلة الحروف التي استٌدعيت عبرها وعلى فهارسها.
mapIndexedNotNullTo
تضيف الدالة mapIndexedNotNullTo() إلى المجموعة المتغيرة المُمرّرة destination النتائج غير المعدومة (non-null) لتطبيق الدالةtransform على عناصر سلسلة الحروف التي استٌدعيت عبرها وعلى فهارسها.
mapIndexedTo
تضيف الدالة mapIndexedTo() إلى المجموعة المتغيرة المُمرّرة destination نتائج تطبيق الدالة transform على عناصر سلسلة الحروف التي استٌدعيت عبرها وعلى فهارسها.
mapNotNull
تعيد الدالة mapNotNull() لائحة مكونة من النتائج غير المعدومة (non-null) لتطبيق الدالة transform المُمرّرة على عناصر سلسلة الحروف التي استٌدعيت عبرها.
mapNotNullTo
تضيف الدالة mapNotNullTo() إلى المجموعة المتغيرة المُمرّرة destination النتائج غير المعدومة (non-null) لتطبيق الدالة transform على عناصر سلسلة الحروف التي استٌدعيت عبرها.
mapTo
تضيف الدالة mapTo() إلى المجموعة المتغيرة المُمرّرة destination نتائج تطبيق الدالة transform على عناصر سلسلة الحروف التي استٌدعيت عبرها.
match
تعيد الدالة match() مصفوفة مكونة من السلاسل النصية المُطابقة للتعبير النمطي المُمرّر regex في السلسلة النصية التي استٌدعيت عبرها.
matches
تعيد الدالة matches() القيمة true إن طابقت السلسلة النصية أو سلسلة الحروف التي استٌدعيت عبرها التعبير النمطي المُمرّر regex.
max
تعيد الدالة max() أكبر حرف في السلسلة النصية التي استٌدعيت عبرها أو تعيد null إن كانت فارغة.
maxBy
تعيد الدالة maxBy() أول حرف في سلسلة الحروف التي استٌدعيت عبرها والذي يعيد أكبر قيمة بعد تمريره إلى الدالة selector أو تعيد null إن كانتسلسلة الحروف فارغة.
maxWith
تعيد الدالة maxWith() أول حرف في سلسلة الحروف التي استٌدعيت عبرها والذي له أكبر قيمة نسبة إلى المُقارِن comparator أو تعيد null إن كانتسلسلة الحروف فارغة.
min
تعيد الدالة min() أصغر حرف في السلسلة النصية التي استٌدعيت عبرها أو تعيد null إن كانت فارغة.
minBy
تعيد الدالة minBy() أول حرف في سلسلة الحروف التي استٌدعيت عبرها والذي يعيد أصغر قيمة بعد تمريره إلى الدالة selector أو تعيد null إن كانت سلسلة الحروف فارغة.
minWith
تعيد الدالة minWith() أول حرف في سلسلة الحروف التي استٌدعيت عبرها والذي له أصغر قيمة نسبة إلى المُقارِن comparator أو تعيد null إن كانت سلسلة الحروف فارغة.
none
تعيد الدالة none() القيمة true إن كانت سلسلة الحروف التي استٌدعيت عبرها فارغة. وفي حال تمرير شرط منطقي كوسيط فستعيد true إن كانت كل عناصر سلسلة الحروف لا تحقق ذلك الشرط المنطقي.
offsetByCodePoints
تعيد الدالة offsetByCodePoints() الفهرس في السلسلة النصية التي استٌدعيت عبرها والذي يكون إزاحة (offset) من الوسيط index عبر كود اليونيكود (Unicode code point)المُمرّر codePointOffset.