الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/Regex»

المراجعة الحالية بتاريخ 15:55، 30 أغسطس 2018

يمثل الصنف Regex تعبيرًا نمطيا قابلًا للتعديل (immutable regular expression). إن أردت الاطلاع على المزيد من المعلومات المتعلقة بصياغة النمط (pattern)، انتقل إلى صفحة الصنف Pattern.

actual class Regex : Serializable

الدوال البانية

`<init>`

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

الخاصيات

`options`

تمثل هذه الخاصية مجموعةَ الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعي معها.

`pattern`

تمثل هذه الخاصية النمط الأولي الذي استُخدم في إنشاء التعبير النمطي الذي استُدعي معها.

الدوال

`containsMatchIn`

تتحقق هذه الدالة إن كان بإمكان التعبير النمطي الذي استُدعي معها مطابقة محرفٍ واحدٍ على الأقل من سلسلة المحارف المُمرّرة إليه.

find

تبحث هذه الدالة عن أول محرف متطابق مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف الممرَّرة إليها. يمكن البحث في سلسلة المحارف المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.

findAll

تبحث هذه الدالة عن جميع المحارف المتطابقة مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف الممرَّرة إليها. يمكن البحث في سلسلة المحارف المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.

matchEntire

تحاول هذه الدالة مطابقة جميع محارف السلسلة الممررة إليها مع التعبير النمطي الذي استدعي معها.

matches

تتحقق هذه الدالة من مطابقة جميع محارف السلسلة الممررة إليها مع التعبير النمطي الذي استدعي معها.

replace

تبدل هذه الدالة سلسلة النصية معينة مكان كل تطابقات التعبير النمطي الذي استدعي معها في سلسلة المحارف المُمرّرة إليها أو سلسلة المحارف التي تعيدها الدالة الممررة إليها.

replaceFirst

تبدل هذه الدالة سلسلة النصية معينة مكان أول مطابقة للتعبير النمطي الذي استدعي معها في سلسلة المحارف المُمرّرة إليها.

split

تقتطع هذه الدالة المحارف الموجودة بين الأجزاء المتطابقة مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف الممررة إليها.

toPattern

تحول هذه الدالة كائنًا من النوع Regex (تعبيرًا نمطيًا) إلى النوع Pattern (نمط).

toString

تحول هذه الدالة تعبيرًا نمطيًّا إلى سلسلة نصية (أي نمط [Pattern] ذلك التعبير النمطي).

الدوال الموروثة (Inherited Functions)

`equals`

تتحقق هذه الدالة إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معه.

`hashCode`

تعيد هذه الدالة الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها.

الدوال المصاحبة (Companion Object Functions)

`escape`

`escapeReplacement`

`fromLiteral`

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE:الصنف <code>‎‎Regex</code>‎ في Kotlin}}</noinclude>
-يمثل  [[Kotlin/kotlin.text/Regex/index|تعبيرًا  نمطيا]]  قابلا للتعديل (immutable regular expression).
+يمثل الصنف <code>Regex</code> [[Kotlin/kotlin.text/Regex/index|تعبيرًا  نمطيا]] قابلًا للتعديل (immutable regular expression). إن أردت الاطلاع على المزيد من المعلومات المتعلقة بصياغة النمط (pattern)، انتقل إلى صفحة الصنف <code>[[Kotlin/kotlin.text/java.util.regex.Pattern/index|Pattern]]</code>.<syntaxhighlight lang="kotlin">
+actual class Regex : Serializable
+</syntaxhighlight>
 == الدوال البانية ==
 === <code>[[Kotlin/kotlin.text/Regex/Init|<init>]]</code> ===
-ينشِئ التابع <code>Regex()‎</code> <nowiki/>[[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] (regular expression) انطلاقًا من السلسلة النصية المُمرّرة.
+تنشئ الدالة <code>Regex()‎</code> [[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] (regular expression) انطلاقًا من [[Kotlin/String|السلسلة النصية]] المُمرّرة إليه.
 == الخاصيات ==
 === <code>[[Kotlin/kotlin.text/Regex/options|options]]</code> ===
-تعبر الخاصية <code>options‎</code> عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
+تمثل هذه الخاصية مجموعةَ الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعي معها.
 === <code>[[Kotlin/kotlin.text/Regex/pattern|pattern]]</code> ===
-تعيد الخاصية <code>pattern</code>  السلسلة النصية النمطية (pattern string) التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
+تمثل هذه الخاصية النمط الأولي الذي استُخدم في إنشاء التعبير النمطي الذي استُدعي معها.
 == الدوال ==
 === <code>[[Kotlin/kotlin.text/Regex/containsMatchIn|containsMatchIn]]</code> ===
-تعيد الدالة<code>containsMatchIn()‎</code> القيمة <code>true</code> إن وَجَد <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعيت عبره على الأقل تطابقا واحدًا في الوسيط المُمرّر.
+تتحقق هذه الدالة إن كان بإمكان التعبير النمطي الذي استُدعي معها مطابقة محرفٍ واحدٍ على الأقل من [[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليه.
-=== <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> ===
+تبحث هذه الدالة عن أول محرف متطابق مع التعبير النمطي الذي استُدعي معها في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] الممرَّرة إليها. يمكن البحث في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
-تعيد الدالة<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/findAll|findAll]]</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> ===
+تبحث هذه الدالة عن جميع المحارف المتطابقة مع التعبير النمطي الذي استُدعي معها في [[Kotlin/CharSequence|سلسلة المحارف]] الممرَّرة إليها. يمكن البحث في [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
-إن كانت جميع حروف الوسيط الممرّر <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/matchEntire|matchEntire]]</code>
-تستبدل الدالة<code>replace()‎</code> كل المطابقات <nowiki/>[[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استُدعيت عبره في الكائن المُمرّر <code>input</code>، بالسلسلة النصية المُمرّرة <code>replacement</code>.
-=== <code>[[Kotlin/kotlin.text/Regex/replaceFirst|replaceFirst]]</code> ===
+تحاول هذه الدالة مطابقة جميع محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] الممررة إليها مع التعبير النمطي الذي استدعي معها.
-تستبدل الدالة<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/matches|matches]]</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> ===
+تتحقق هذه الدالة من مطابقة جميع محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] الممررة إليها مع التعبير النمطي الذي استدعي معها.
-تعيد الدالة<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/replace|replace]]</code>
-تعيد الدالة<code>toString()‎</code> تمثيلًا نصيًا <nowiki/>[[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استُدعيت عبره، أي نمط (<code>Pattern)</code> ذلك التعبير.
+تبدل هذه الدالة سلسلة النصية معينة مكان كل تطابقات التعبير النمطي الذي استدعي معها في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليها أو <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي تعيدها الدالة الممررة إليها.
+<code>[[Kotlin/kotlin.text/Regex/replaceFirst|replaceFirst]]</code>
+تبدل هذه الدالة سلسلة النصية معينة مكان أول مطابقة للتعبير النمطي الذي استدعي معها في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليها.
+<code>[[Kotlin/kotlin.text/Regex/split|split]]</code>
+تقتطع هذه الدالة المحارف الموجودة بين الأجزاء المتطابقة مع التعبير النمطي الذي استُدعي معها في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] الممررة إليها.
+<code>[[Kotlin/kotlin.text/Regex/toPattern|toPattern]]</code>
+تحول هذه الدالة كائنًا من النوع <code>Regex</code> (تعبيرًا نمطيًا) إلى النوع <code>[[Kotlin/kotlin.text/java.util.regex.Pattern/index|Pattern]]</code> (نمط).
+<code>[[Kotlin/kotlin.text/Regex/toString|toString]]</code>
+تحول هذه الدالة تعبيرًا نمطيًّا إلى سلسلة نصية (أي نمط [<code>[[Kotlin/kotlin.text/java.util.regex.Pattern/index|Pattern]]</code>] ذلك التعبير النمطي).
 == الدوال الموروثة (Inherited Functions) ==
 === <code>[[Kotlin/Any/equals|equals]]</code> ===
-بين الدالة <code>equals()</code>‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت عبره.
+تتحقق هذه الدالة إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معه.
 === <code>[[Kotlin/Any/hashCode|hashCode]]</code> ===
-يعيد التابع <code>hashCode()</code>‎ قيمة الشيفرة hash code الخاصّة بالكائن الذي استُدعي عبره.
+تعيد هذه الدالة الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها.
+== الدوال المصاحبة (Companion Object Functions) ==
+=== <code>[[Kotlin/kotlin.text/Regex/escape|escape]]</code> ===
+=== <code>[[Kotlin/kotlin.text/Regex/escapeReplacement|escapeReplacement]]</code> ===
+=== <code>[[Kotlin/kotlin.text/Regex/fromLiteral|fromLiteral]]</code> ===
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Classes]]
+[[تصنيف:Kotlin Class]]
+[[تصنيف:Kotlin Text]]
 [[تصنيف:Kotlin Regex]]