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

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

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

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

fun toPattern(): Pattern

المنصة المطلوبة: JVM.

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

تعاد نسخةٌ من الصنف Pattern لها نفس السلسلة النصية النمطية (pattern string) والخيارات التي يملكها التعبير النمطي المعطى.

أمثلة

ينشِئ التابع Regex()‎ في الشيفرة التالية تعبيرًا نمطيًا باسم reg لمطابقة القيم العددية، ثم يُستدعَى معه الدالة toPattern()‎ لتحويل ذلك التعبير النمطي إلى النمط Pattern:

fun main(args: Array<String>) {
    // يطابق التعبير النمطي التالي القيم العددية
    val reg = Regex("""-?\d+(\.\d+)?""")

    println(reg.toPattern()) // => -?\d+(\.\d+)?
}

انظر أيضًا

الدالة toString()‎: تحول تعبيرًا نمطيًّا إلى سلسلة نصية (أي نمط [Pattern] ذلك التعبير النمطي).
الخاصية Regex.pattern: تمثل النمط الأولي الذي استُخدم في إنشاء التعبير النمطي الذي استُدعي معها.
الخاصية Regex.options: تمثل مجموعةَ الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعي معها.

مصادر

صفحة الدالة Regex.toPattern()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>Regex.toPattern()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>Regex.toPattern()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة<code>toPattern()‎</code> نسخة من الصنف <code>[[Kotlin/kotlin.text/java.util.regex.Pattern/index|Pattern]]</code> والتي لها نفس السلسلة النصية النمطية (pattern string)  [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استُدعيت عبره، وهو ما يتيح استخدام <code>Regex</code> حيثما يكون <code>[[Kotlin/kotlin.text/java.util.regex.Pattern/index|Pattern]]</code>  مطلوبًا.
+تحول الدالة <code>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|Regex]]</code> في المكان الذي يطلب فيه استعمال الكائن <code>[[Kotlin/kotlin.text/java.util.regex.Pattern/index|Pattern]]</code>.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
 fun toPattern(): Pattern
-</syntaxhighlight>
+</syntaxhighlight>'''المنصة المطلوبة''': JVM.
 ==القيمة المعادة==
-نسخة من الصنف <code>[[Kotlin/kotlin.text/java.util.regex.Pattern/index|Pattern]].</code>
+تعاد نسخةٌ من الصنف <code>[[Kotlin/kotlin.text/java.util.regex.Pattern/index|Pattern]]</code> لها نفس [[Kotlin/kotlin.text/Regex/pattern|السلسلة النصية النمطية]] (pattern string) و<nowiki/>[[Kotlin/kotlin.text/Regex/options|الخيارات]] التي يملكها [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] المعطى.
 ==أمثلة==
-===استخدام التابع <code>toPattern()‎</code>===
+ينشِئ التابع <code>[[Kotlin/kotlin.text/Regex/Init|Regex()]]‎</code> في الشيفرة التالية <nowiki/>[[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] باسم <code>reg</code> لمطابقة القيم العددية، ثم يُستدعَى معه الدالة <code>toPattern()‎</code> لتحويل ذلك التعبير النمطي إلى النمط <code>[[Kotlin/kotlin.text/java.util.regex.Pattern/index|Pattern]]</code>:<syntaxhighlight lang="kotlin">
-ينشِئ التابع <code>[[Kotlin/kotlin.text/Regex/Init|Regex()]]‎</code> في الشيفرة الآتية <nowiki/>[[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] باسم <code>reg</code> لمطابقة التعابير العددية، ثم يستدعي عبره الدالة <code>toPattern()‎</code> لإعادة نسخة من الصنف <code>[[Kotlin/kotlin.text/java.util.regex.Pattern/index|Pattern]]</code> لها نفس السلسلة النصية النمطية (pattern string)  [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] <code>reg</code>، ثم يطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val reg = Regex("""-?\d+(\.\d+)?""") // يطابق هذا التعبير النمطي التعابير العددية، مثل: 45
+    // يطابق التعبير النمطي التالي القيم العددية
+    val reg = Regex("""-?\d+(\.\d+)?""")
-println(reg.toPattern()) // => -?\d+(\.\d+)?
+     println(reg.toPattern()) // => -?\d+(\.\d+)?
 }
 </syntaxhighlight>
-==أنظر أيضًا==
+==انظر أيضًا==
-* <code>[[Kotlin/kotlin.text/Regex/replace| replace()‎]]:</code> تستبدل الدالة<code>replace()‎</code> كل المطابقات للتعبير النمطي الذي استُدعيت عبره في الكائن المُمرّر  <code>input</code>،  بالسلسلة  النصية  المُمرّرة <code>replacement</code>.
+* الدالة <code>[[Kotlin/kotlin.text/Regex/toString|toString()‎]]</code>: تحول [[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًّا]] إلى [[Kotlin/String|سلسلة نصية]] (أي نمط [<code>[[Kotlin/kotlin.text/java.util.regex.Pattern/index|Pattern]]</code>] ذلك التعبير النمطي).
-* <code>[[Kotlin/kotlin.text/Regex/findAll| findAll()‎]]:</code> تعيد كل المطابقات [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استُدعيت عبره  في الوسيط المُمرّر <code>input،</code>بداية من الفهرس المحدد بالوسيط <code>startIndex.</code>
+* الخاصية <code>[[Kotlin/kotlin.text/Regex/pattern|Regex.pattern]]</code>: تمثل النمط الأولي الذي استُخدم في إنشاء [[Kotlin/kotlin.text/Regex|التعبير النمطي]] الذي استُدعي معها.
-* <code>[[Kotlin/kotlin.text/Regex/matchEntire| matchEntire()‎]]:</code>إن كانت جميع حروف الوسيط الممرّر <code>input</code> تطابق التعبير النمطي الذي استُدعيت عبره، فإن الدالة<code>matchEntire()‎</code> تعيد نسخة من الصنف<code>MatchResult</code> تحتوي الكائن المُمرّر نفسه، وإلا فستعيد القيمة المعدومة <code>null</code>.
+* الخاصية <code>[[Kotlin/kotlin.text/Regex/options|Regex.options]]</code>: تمثل مجموعةَ الخيارات التي استُخدمت في إنشاء [[Kotlin/kotlin.text/Regex|التعبير النمطي]] الذي استُدعي معها.
 ==مصادر==
-* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/to-pattern.html الدالة  Regex.toPattern()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/to-pattern.html صفحة الدالة Regex.toPattern()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin Regex]]