الفرق بين المراجعتين لصفحة: «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> كل المطابقات  [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استُدعيت عبره في الكائن المُمرّر <code>input</code>، [[Kotlin/String|بالسلسلة النصية]] المُمرّرة <code>replacement</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">
-actual fun replace(
+fun toPattern(): Pattern
-    input: CharSequence,
-    replacement: String
+</syntaxhighlight>'''المنصة المطلوبة''': JVM.
-): String
-</syntaxhighlight>
+==القيمة المعادة==
-==القيمة المُعادة==
+تعاد نسخةٌ من الصنف <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|التعبير النمطي]] المعطى.
-[[Kotlin/String|سلسلة نصية]]
 ==أمثلة==
-===استخدام التابع <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> لاستبدال المطابقات الموجودة في [[Kotlin/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.replace("ab12cd34ef", "X")) // => abXcdXef
+     println(reg.toPattern()) // => -?\d+(\.\d+)?
 }
 </syntaxhighlight>
-==أنظر أيضًا==
+==انظر أيضًا==
-* الخاصية <code>[[Kotlin/kotlin.text/Regex/pattern|pattern]]:</code> تعيد السلسلة النصية النمطية (pattern string) التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
+* الدالة <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/options|Regex.options]]</code>: تمثل مجموعةَ الخيارات التي استُخدمت في إنشاء [[Kotlin/kotlin.text/Regex|التعبير النمطي]] الذي استُدعي معها.
-* الخاصية <code>[[Kotlin/kotlin.text/Regex/options|options]]:</code> تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
 ==مصادر==
-* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/replace.html الدالة  Regex.toPattern()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/to-pattern.html صفحة الدالة Regex.toPattern()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Methods]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin Regex]]