الفرق بين المراجعتين لصفحة: «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|لتعبير  نمطي]].
+يمثل الصنف <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/matches|matches]]</code> ===
-=== <code>[[Kotlin/kotlin.text/Regex/replace|replace]]</code> ===
-=== <code>[[Kotlin/kotlin.text/Regex/replaceFirst|replaceFirst]]</code> ===
-=== <code>[[Kotlin/kotlin.text/Regex/split|split]]</code> ===
-=== <code>[[Kotlin/kotlin.text/Regex/toPattern|toPattern]]</code> ===
-=== <code>[[Kotlin/kotlin.text/Regex/toString|toString]]</code> ===
+<code>[[Kotlin/kotlin.text/Regex/find|find]]</code>
+تبحث هذه الدالة عن أول محرف متطابق مع التعبير النمطي الذي استُدعي معها في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] الممرَّرة إليها. يمكن البحث في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
-== الأنواع ==
+<code>[[Kotlin/kotlin.text/Regex/findAll|findAll]]</code>
-===<code>[[Kotlin/kotlin.text/MatchResult/Destructured/index|Destructured]]</code>===
+تبحث هذه الدالة عن جميع المحارف المتطابقة مع التعبير النمطي الذي استُدعي معها في [[Kotlin/CharSequence|سلسلة المحارف]] الممرَّرة إليها. يمكن البحث في [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
-يوفر مركبات التعيين التفكيكي (destructuring assignment) لمجموعة من القيم.
-== الخاصيات ==
+<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>
-===<code>[[Kotlin/kotlin.text/MatchResult/destructured|destructured‎]]</code>===
+تبدل هذه الدالة سلسلة النصية معينة مكان أول مطابقة للتعبير النمطي الذي استدعي معها في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليها.
-الخاصية <code>destructured‎</code> تعيد نسخة من الصنف <code>[[Kotlin/kotlin.text/MatchResult/Destructured/index|MatchResult.Destructured]]،</code> والتي توفّر مركبات لتفكيك قيم المجموعة المُطابقة. المركبة الأولى تقابل قيمة المجموعة المُطابقَة الأولى، والمركبة الثانية تقابل الثانية، وهكذا دواليك.
-===<code>[[Kotlin/kotlin.text/MatchResult/groupValues|groupValues]]</code>===
+<code>[[Kotlin/kotlin.text/Regex/split|split]]</code>
-تعيد الخاصية <code>groupValues</code> لائحة تضم مجموعة المُطابقات  <nowiki/>[[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]]. حجم تلك اللائحة يساوي <code>groupCount + 1،</code> حيث<code>groupCount</code>هو عدد المجموعات المطابَقة في  <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]]. تلك المجموعات مُفهرسة من 1 حتى <code>groupCount،</code> والمجموعة ذات الفهرس <code>0</code> توافق المطابقة الكلية.
-===<code>[[Kotlin/kotlin.text/MatchResult/groups|groups]]</code>===
+تقتطع هذه الدالة المحارف الموجودة بين الأجزاء المتطابقة مع التعبير النمطي الذي استُدعي معها في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] الممررة إليها.
-تعيد الخاصية <code>groups</code> كائنًا من النوع <code>[[Kotlin/kotlin.text/MatchGroupCollection/index|MatchGroupCollection]]</code> يضم مجموعة المُطابقات الموجودة في <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]]. حجم تلك المجموعة يساوي<code>groupCount + 1،</code> حيث<code>groupCount</code> هو عدد المجموعات المطابَقة في  <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]]. تلك المجموعات مُفهرسة من 1 حتى <code>groupCount،</code>والمجموعة ذات الفهرس <code>0</code> توافق المطابقة الكلية.
-===<code>[[Kotlin/kotlin.text/MatchResult/range|range]]</code>===
+<code>[[Kotlin/kotlin.text/Regex/toPattern|toPattern]]</code>
-تعيد الخاصية <code>range</code> مجال الفهارس الذي يحدد مكان مُطابقة <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]].
-===<code>[[Kotlin/kotlin.text/MatchResult/value|value]]</code>===
+تحول هذه الدالة كائنًا من النوع <code>Regex</code> (تعبيرًا نمطيًا) إلى النوع <code>[[Kotlin/kotlin.text/java.util.regex.Pattern/index|Pattern]]</code> (نمط).
-تعيد الخاصية <code>value</code> جزء من السلسلة النصية المُدخلة والمُطابقة <nowiki/>[[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]].
-== الدوال ==
+<code>[[Kotlin/kotlin.text/Regex/toString|toString]]</code>
-===<code>[[Kotlin/kotlin.text/MatchResult/next|next]]</code>===
+تحول هذه الدالة تعبيرًا نمطيًّا إلى سلسلة نصية (أي نمط [<code>[[Kotlin/kotlin.text/java.util.regex.Pattern/index|Pattern]]</code>] ذلك التعبير النمطي).
-تعيد الدالة<code>next()‎</code> كائنًا من النوع <code>[[Kotlin/kotlin.text/MatchResult/index|MatchResult]]</code> يحتوي نتائج المطابقة الموالية <nowiki/>[[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]]، بداية من فهرس آخر مطابقة.
 == الدوال الموروثة (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> ===
-=== <code>[[Kotlin/Any/toString|toString]]</code> ===
-يعيد التابع <code>toString()‎</code> تمثيلًا نصيًا للكائن الذي يُستدعى عبره.
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Classes]]
+[[تصنيف:Kotlin Class]]
+[[تصنيف:Kotlin Text]]
 [[تصنيف:Kotlin Regex]]