الفرق بين المراجعتين ل"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> [[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] (regular expression) انطلاقًا من [[Kotlin/String|السلسلة النصية]] المُمرّرة إليه.
 == الخاصيات ==
 === <code>[[Kotlin/kotlin.text/Regex/options|options]]</code> ===
+تمثل هذه الخاصية مجموعةَ الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعي معها.
 === <code>[[Kotlin/kotlin.text/Regex/pattern|pattern]]</code> ===
+تمثل هذه الخاصية النمط الأولي الذي استُخدم في إنشاء التعبير النمطي الذي استُدعي معها.
 == الدوال ==
 === <code>[[Kotlin/kotlin.text/Regex/containsMatchIn|containsMatchIn]]</code> ===
-=== <code>[[Kotlin/kotlin.text/Regex/find|find]]</code> ===
+تتحقق هذه الدالة إن كان بإمكان التعبير النمطي الذي استُدعي معها مطابقة محرفٍ واحدٍ على الأقل من [[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليه.
-=== <code>[[Kotlin/kotlin.text/Regex/findAll|findAll]]</code> ===
-=== <code>[[Kotlin/kotlin.text/Regex/matchEntire|matchEntire]]</code> ===
+<code>[[Kotlin/kotlin.text/Regex/find|find]]</code>
-=== <code>[[Kotlin/kotlin.text/Regex/matches|matches]]</code> ===
-=== <code>[[Kotlin/kotlin.text/Regex/replace|replace]]</code> ===
+تبحث هذه الدالة عن أول محرف متطابق مع التعبير النمطي الذي استُدعي معها في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] الممرَّرة إليها. يمكن البحث في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
-=== <code>[[Kotlin/kotlin.text/Regex/replaceFirst|replaceFirst]]</code> ===
-=== <code>[[Kotlin/kotlin.text/Regex/split|split]]</code> ===
+<code>[[Kotlin/kotlin.text/Regex/findAll|findAll]]</code>
-=== <code>[[Kotlin/kotlin.text/Regex/toPattern|toPattern]]</code> ===
-=== <code>[[Kotlin/kotlin.text/Regex/toString|toString]]</code> ===
+تبحث هذه الدالة عن جميع المحارف المتطابقة مع التعبير النمطي الذي استُدعي معها في [[Kotlin/CharSequence|سلسلة المحارف]] الممرَّرة إليها. يمكن البحث في [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
+<code>[[Kotlin/kotlin.text/Regex/matchEntire|matchEntire]]</code>
+تحاول هذه الدالة مطابقة جميع محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] الممررة إليها مع التعبير النمطي الذي استدعي معها.
+<code>[[Kotlin/kotlin.text/Regex/matches|matches]]</code>
+تتحقق هذه الدالة من مطابقة جميع محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] الممررة إليها مع التعبير النمطي الذي استدعي معها.
+<code>[[Kotlin/kotlin.text/Regex/replace|replace]]</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]]