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

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

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

البنية العامة

Regex(pattern: String)
Regex(pattern: String, option: RegexOption)
Regex(pattern: String, options: Set<RegexOption>)

تنشئ الدالة Regex()‎ تعبيرًا نمطيًا من النمط pattern مع ضبطه وفقًا الخيار option أو مجموعة الخيارات options (أو القيمة الافتراضية لهذه الخيارات إن لم يعطَ الوسيط option) التي تضبط ذلك النمط.

المعاملات

`pattern`

سلسلة نصية تمثل النمط الذي سينشأ منه تعبير نمطي.

`option`

كائن من النوع RegexOption يحوي خيارًا واحدًا من خيارات التعابير النمطية.

`options`

مجموعة تتألف من عدة كائنات من النوع RegexOption تمثل خيارات التعابير النمطية.

القيم المعادة

يعاد كائن من النوع Regex يحتوي على التعبير النمطي pattern بعد ضبطه وفقًا للخيار option أو مجموعة الخيارات options المعطاة أو القيمة الافتراضية لها (إن لم يُعطَ أي خيار).

أمثلة

ينشِئ التابع Regex()‎ في الشيفرة التالية تعبيرًا نمطيًا باسم reg ثم يطابق سلسلةً نصيةً معه باستخدام الدالة containsMatchIn()‎:

fun main(args: Array<String>) {
    val reg = Regex("""-?\d+(\.\d+)?""")

    print(reg.containsMatchIn("xabcdy")) // false
    print(reg.containsMatchIn("xabc22dy")) // true
}

انظر أيضًا

الدالة containsMatchIn()‎: تتحقق إن كان بإمكان التعبير النمطي الذي استُدعي معها مطابقة محرفٍ واحدٍ على الأقل من سلسلة المحارف المُمرّرة إليه.
الدالة findAll()‎: تبحث عن جميع المحارف المتطابقة مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف الممرَّرة إليها. يمكن البحث في سلسلة المحارف المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
الدالة matchEntire()‎: تحاول مطابقة جميع محارف السلسلة الممررة إليها مع التعبير النمطي الذي استدعي معها.
الدالة replace()‎: تبدل سلسلة النصية معينة مكان كل تطابقات التعبير النمطي الذي استدعي معها في سلسلة المحارف المُمرّرة إليها أو سلسلة المحارف التي تعيدها الدالة الممررة إليها.
الدالة split()‎: تقتطع المحارف الموجودة بين الأجزاء المتطابقة مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف الممررة إليها.
الدالة toPattern()‎: تحول كائنًا من النوع Regex (تعبيرًا نمطيًا) إلى النوع Pattern (نمط).
الخاصية Regex.options: تمثل مجموعةَ الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعي معها.
الخاصية Regex.pattern: تمثل النمط الأولي الذي استُخدم في إنشاء التعبير النمطي الذي استُدعي معها.
الأصناف والبواني (constructors) في لغة Kotlin.

مصادر

صفحة <init> للصنف Regex في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: التهيئة الأولية <code><init></code> للصنف <code>Regex</code> في Kotlin}}</noinclude>
 تنشئ الدالة <code>Regex()‎</code> [[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] (regular expression) انطلاقًا من [[Kotlin/String|السلسلة النصية]] المُمرّرة إليه.
+==البنية العامة==
-== البنية العامة ==
 <syntaxhighlight lang="kotlin">
 Regex(pattern: String)
 Regex(pattern: String, option: RegexOption)
 Regex(pattern: String, options: Set<RegexOption>)
-</syntaxhighlight>تنشئ الدالة <code>Regex()‎</code> [[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] من النمط <code>pattern</code> مع ضبطه وفقًا الخيار <code>option</code> أو مجموعة الخيارات <code>options</code> (أو القيمة الافتراضية لهذه الخيارات إن لم يعطَ الوسيط <code>option</code>) التي تضبط ذلك النمط.
+</syntaxhighlight>تنشئ الدالة <code>Regex()‎</code> [[Kotlin/kotlin.text/Regex|تعبيرًا نمطيًا]] من النمط <code>pattern</code> مع ضبطه وفقًا الخيار <code>option</code> أو مجموعة الخيارات <code>options</code> (أو القيمة الافتراضية لهذه الخيارات إن لم يعطَ الوسيط <code>option</code>) التي تضبط ذلك النمط.
-== القيم المعادة ==
+== المعاملات ==
+=== <code>pattern</code> ===
+سلسلة نصية تمثل النمط الذي سينشأ منه [[Kotlin/kotlin.text/Regex|تعبير نمطي]].
+=== <code>option</code> ===
+كائن من النوع <code>[[KOtlin/kotlin.text/RegexOption|RegexOption]]</code> يحوي خيارًا واحدًا من خيارات التعابير النمطية.
+=== <code>options</code> ===
+[[Kotlin/collections/Set|مجموعة]] تتألف من عدة كائنات من النوع <code>[[KOtlin/kotlin.text/RegexOption|RegexOption]]</code> تمثل خيارات التعابير النمطية.
+==القيم المعادة==
 يعاد كائن من النوع <code>[[Kotlin/kotlin.text/Regex|Regex]]</code> يحتوي على التعبير النمطي <code>pattern</code> بعد ضبطه وفقًا للخيار <code>option</code> أو مجموعة الخيارات <code>options</code> المعطاة أو القيمة الافتراضية لها (إن لم يُعطَ أي خيار).
+==أمثلة==
-== أمثلة ==
 ينشِئ التابع <code>Regex()‎</code> في الشيفرة التالية [[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] باسم <code>reg</code> ثم يطابق سلسلةً نصيةً معه باستخدام الدالة <code>[[Kotlin/kotlin.text/Regex/containsMatchIn|containsMatchIn()]]‎</code>:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
@@ سطر 20: / سطر 30: @@
 }
 </syntaxhighlight>
-== انظر أيضًا ==
+==انظر أيضًا==
-* الخاصية <code>[[Kotlin/kotlin.text/Regex/options|Regex.options]]</code>: تمثل مجموعةَ الخيارات التي استُخدمت في إنشاء [[Kotlin/kotlin.text/Regex|التعبير النمطي]] الذي استُدعي معها.
+*الدالة <code>[[Kotlin/kotlin.text/Regex/containsMatchIn|containsMatchIn()‎]]</code>: تتحقق إن كان بإمكان [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعي معها مطابقة محرفٍ واحدٍ على الأقل من [[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليه.
-* الخاصية <code>[[Kotlin/kotlin.text/Regex/pattern|Regex.pattern]]</code>: النمط الأولي الذي استُخدم في إنشاء [[Kotlin/kotlin.text/Regex|التعبير النمطي]] الذي استُدعي معها.
+*الدالة <code>[[Kotlin/kotlin.text/Regex/findAll|findAll()‎]]</code>: تبحث عن جميع المحارف المتطابقة مع [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعي معها في [[Kotlin/CharSequence|سلسلة المحارف]] الممرَّرة إليها. يمكن البحث في [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
-* الدالة <code>[[Kotlin/kotlin.text/Regex/containsMatchIn|containsMatchIn()‎]]</code>: تتحقق إن كان بإمكان [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعي معها مطابقة محرفٍ واحدٍ على الأقل من [[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليه.
+*الدالة <code>[[Kotlin/kotlin.text/Regex/matchEntire|matchEntire()‎]]</code>: تحاول مطابقة جميع محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] الممررة إليها مع <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استدعي معها.
-* الدالة <code>[[Kotlin/kotlin.text/Regex/find|find()‎]]</code>: تبحث عن أول محرف متطابق مع [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعي معها في [[Kotlin/CharSequence|سلسلة المحارف]] الممرَّرة إليها. يمكن البحث في [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
+*الدالة <code>[[Kotlin/kotlin.text/Regex/replace|replace()‎]]</code>: تبدل سلسلة النصية معينة مكان كل تطابقات <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استدعي معها في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليها أو <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي تعيدها الدالة الممررة إليها.
-* الدالة <code>[[Kotlin/kotlin.text/Regex/findAll|findAll()‎]]</code>: تبحث عن جميع المحارف المتطابقة مع [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعي معها في [[Kotlin/CharSequence|سلسلة المحارف]] الممرَّرة إليها. يمكن البحث في [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
+*الدالة <code>[[Kotlin/kotlin.text/Regex/split|split()‎]]</code>: تقتطع المحارف الموجودة بين الأجزاء المتطابقة مع <nowiki/>[[Kotlin/kotlin.text/Regex|التعبير النمطي]] الذي استُدعي معها في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] الممررة إليها.
-* [[Kotlin/classes|الأصناف والبواني (constructors) في لغة Kotlin.]]
+*الدالة <code>[[Kotlin/kotlin.text/Regex/toPattern|toPattern()‎]]</code>: تحول كائنًا من النوع <code>[[Kotlin/kotlin.text/Regex|Regex]]</code> (تعبيرًا نمطيًا) إلى النوع <code>[[Kotlin/kotlin.text/java.util.regex.Pattern/index|Pattern]]</code> (نمط).
+*الخاصية <code>[[Kotlin/kotlin.text/Regex/options|Regex.options]]</code>: تمثل مجموعةَ الخيارات التي استُخدمت في إنشاء [[Kotlin/kotlin.text/Regex|التعبير النمطي]] الذي استُدعي معها.
-== مصادر ==
+*الخاصية <code>[[Kotlin/kotlin.text/Regex/pattern|Regex.pattern]]</code>: تمثل النمط الأولي الذي استُخدم في إنشاء [[Kotlin/kotlin.text/Regex|التعبير النمطي]] الذي استُدعي معها.
-* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/-init-.html صفحة <init> للصنف Regex في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[[Kotlin/classes|الأصناف والبواني (constructors) في لغة Kotlin.]]
+==مصادر==
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/-init-.html صفحة <init> للصنف Regex في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin init]]
 [[تصنيف:Kotlin Text]]
 [[تصنيف:Kotlin Regex]]