الفرق بين المراجعتين ل"Kotlin/kotlin.text/Regex"
| سطر 5: | سطر 5: | ||
=== <code>[[Kotlin/kotlin.text/Regex/Init|<init>]]</code> === | === <code>[[Kotlin/kotlin.text/Regex/Init|<init>]]</code> === | ||
| + | ينشِئ التابع <code>Regex()</code> <nowiki/>[[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] (regular expression) انطلاقًا من السلسلة النصية المُمرّرة. | ||
== الخاصيات == | == الخاصيات == | ||
=== <code>[[Kotlin/kotlin.text/Regex/options|options]]</code> === | === <code>[[Kotlin/kotlin.text/Regex/options|options]]</code> === | ||
| + | تعبر الخاصية <code>options</code> عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره. | ||
| + | |||
=== <code>[[Kotlin/kotlin.text/Regex/pattern|pattern]]</code> === | === <code>[[Kotlin/kotlin.text/Regex/pattern|pattern]]</code> === | ||
| + | تعيد الخاصية <code>pattern</code> السلسلة النصية النمطية (pattern string) التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره. | ||
== الدوال == | == الدوال == | ||
=== <code>[[Kotlin/kotlin.text/Regex/containsMatchIn|containsMatchIn]]</code> === | === <code>[[Kotlin/kotlin.text/Regex/containsMatchIn|containsMatchIn]]</code> === | ||
| + | تعيد الدالة<code>containsMatchIn()</code> القيمة <code>true</code> إن وَجَد <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعيت عبره على الأقل تطابقا واحدًا في الوسيط المُمرّر. | ||
| + | |||
=== <code>[[Kotlin/kotlin.text/Regex/find|find]]</code> === | === <code>[[Kotlin/kotlin.text/Regex/find|find]]</code> === | ||
| + | تعيد الدالة<code>find()</code> فهرس أول مطابقة <nowiki/>[[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استُدعيت عبره في الوسيط المُمرّر <code>input،</code>بداية من الفهرس المحدد بالوسيط<code>startIndex.</code> | ||
| + | |||
=== <code>[[Kotlin/kotlin.text/Regex/findAll|findAll]]</code> === | === <code>[[Kotlin/kotlin.text/Regex/findAll|findAll]]</code> === | ||
| + | تعيد الدالة<code>findAll()</code> كل المطابقات <nowiki/>[[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استُدعيت عبره في الوسيط المُمرّر <code>input،</code>بداية من الفهرس المحدد بالوسيط<code>startIndex.</code> | ||
| + | |||
=== <code>[[Kotlin/kotlin.text/Regex/matchEntire|matchEntire]]</code> === | === <code>[[Kotlin/kotlin.text/Regex/matchEntire|matchEntire]]</code> === | ||
| + | إن كانت جميع حروف الوسيط الممرّر <code>input</code> تطابق <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعيت عبره، فإن الدالة<code>matchEntire()</code> تعيد نسخة من الصنف<nowiki/>[[Kotlin/kotlin.text/MatchResult/index|<code>MatchResult</code>]] تحتوي الكائن المُمرّر نفسه، وإلا فستعيد القيمة المعدومة <code>null</code>. | ||
| + | |||
=== <code>[[Kotlin/kotlin.text/Regex/matches|matches]]</code> === | === <code>[[Kotlin/kotlin.text/Regex/matches|matches]]</code> === | ||
| + | إن كانت جميع حروف الوسيط الممرّر <code>input</code> تطابق <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعيت عبره، فإن الدالة<code>matches()</code> ستعيد القيمة <code>true</code>، وإلا فستعيد<code>false</code>. | ||
| + | |||
=== <code>[[Kotlin/kotlin.text/Regex/replace|replace]]</code> === | === <code>[[Kotlin/kotlin.text/Regex/replace|replace]]</code> === | ||
| + | تستبدل الدالة<code>replace()</code> كل المطابقات <nowiki/>[[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استُدعيت عبره في الكائن المُمرّر <code>input</code>، بالسلسلة النصية المُمرّرة <code>replacement</code>. | ||
| + | |||
=== <code>[[Kotlin/kotlin.text/Regex/replaceFirst|replaceFirst]]</code> === | === <code>[[Kotlin/kotlin.text/Regex/replaceFirst|replaceFirst]]</code> === | ||
| + | تستبدل الدالة<code>replaceFirst()</code> المطابقة الأولى <nowiki/>[[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استُدعيت عبره في الكائن المُمرّر <code>input</code>، بالسلسلة النصية المُمرّرة<code>replacement</code>. | ||
| + | |||
=== <code>[[Kotlin/kotlin.text/Regex/split|split]]</code> === | === <code>[[Kotlin/kotlin.text/Regex/split|split]]</code> === | ||
| + | تعيد الدالة<code>split()</code> لائحة تضم السلاسل النصية الموجودة بين مطابقات <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعيت عبره في الكائن المُمرّر <code>input</code>، الحد الأقصى لعددالسلاسل النصية يحدده الوسيط <code>limit</code>، وقيمته الابتدائية تساوي <code>0</code>، وتعني لا يوجد عدد أقصى. | ||
| + | |||
=== <code>[[Kotlin/kotlin.text/Regex/toPattern|toPattern]]</code> === | === <code>[[Kotlin/kotlin.text/Regex/toPattern|toPattern]]</code> === | ||
| + | تعيد الدالة<code>toPattern()</code> نسخة من الصنف <code>Pattern</code> والتي لها نفس السلسلة النصية النمطية (pattern string) <nowiki/>[[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استُدعيت عبره، وهو ما يتيح استخدام <code>Regex</code> حيثما يكون <code>Pattern</code> مطلوبًا. | ||
| + | |||
=== <code>[[Kotlin/kotlin.text/Regex/toString|toString]]</code> === | === <code>[[Kotlin/kotlin.text/Regex/toString|toString]]</code> === | ||
| + | تعيد الدالة<code>toString()</code> تمثيلًا نصيًا <nowiki/>[[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استُدعيت عبره، أي نمط (<code>Pattern)</code> ذلك التعبير. | ||
== الدوال الموروثة (Inherited Functions) == | == الدوال الموروثة (Inherited Functions) == | ||
=== <code>[[Kotlin/Any/equals|equals]]</code> === | === <code>[[Kotlin/Any/equals|equals]]</code> === | ||
| − | + | بين الدالة <code>equals()</code> إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت عبره. | |
=== <code>[[Kotlin/Any/hashCode|hashCode]]</code> === | === <code>[[Kotlin/Any/hashCode|hashCode]]</code> === | ||
مراجعة 16:42، 19 يوليو 2018
يمثل تعبيرًا نمطيا قابلا للتعديل (immutable regular expression).
الدوال البانية
<init>
ينشِئ التابع Regex() تعبيرًا نمطيًا (regular expression) انطلاقًا من السلسلة النصية المُمرّرة.
الخاصيات
options
تعبر الخاصية options عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
pattern
تعيد الخاصية pattern السلسلة النصية النمطية (pattern string) التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
الدوال
containsMatchIn
تعيد الدالةcontainsMatchIn() القيمة true إن وَجَد التعبير النمطي الذي استُدعيت عبره على الأقل تطابقا واحدًا في الوسيط المُمرّر.
find
تعيد الدالةfind() فهرس أول مطابقة للتعبير النمطي الذي استُدعيت عبره في الوسيط المُمرّر input،بداية من الفهرس المحدد بالوسيطstartIndex.
findAll
تعيد الدالةfindAll() كل المطابقات للتعبير النمطي الذي استُدعيت عبره في الوسيط المُمرّر input،بداية من الفهرس المحدد بالوسيطstartIndex.
matchEntire
إن كانت جميع حروف الوسيط الممرّر input تطابق التعبير النمطي الذي استُدعيت عبره، فإن الدالةmatchEntire() تعيد نسخة من الصنفMatchResult تحتوي الكائن المُمرّر نفسه، وإلا فستعيد القيمة المعدومة null.
matches
إن كانت جميع حروف الوسيط الممرّر input تطابق التعبير النمطي الذي استُدعيت عبره، فإن الدالةmatches() ستعيد القيمة true، وإلا فستعيدfalse.
replace
تستبدل الدالةreplace() كل المطابقات للتعبير النمطي الذي استُدعيت عبره في الكائن المُمرّر input، بالسلسلة النصية المُمرّرة replacement.
replaceFirst
تستبدل الدالةreplaceFirst() المطابقة الأولى للتعبير النمطي الذي استُدعيت عبره في الكائن المُمرّر input، بالسلسلة النصية المُمرّرةreplacement.
split
تعيد الدالةsplit() لائحة تضم السلاسل النصية الموجودة بين مطابقات التعبير النمطي الذي استُدعيت عبره في الكائن المُمرّر input، الحد الأقصى لعددالسلاسل النصية يحدده الوسيط limit، وقيمته الابتدائية تساوي 0، وتعني لا يوجد عدد أقصى.
toPattern
تعيد الدالةtoPattern() نسخة من الصنف Pattern والتي لها نفس السلسلة النصية النمطية (pattern string) للتعبير النمطي الذي استُدعيت عبره، وهو ما يتيح استخدام Regex حيثما يكون Pattern مطلوبًا.
toString
تعيد الدالةtoString() تمثيلًا نصيًا للتعبير النمطي الذي استُدعيت عبره، أي نمط (Pattern) ذلك التعبير.
الدوال الموروثة (Inherited Functions)
equals
بين الدالة equals() إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت عبره.
hashCode
يعيد التابع hashCode() قيمة الشيفرة hash code الخاصّة بالكائن الذي استُدعي عبره.