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

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

تحول الدالة toString()‎ تعبيرًا نمطيًّا إلى سلسلة نصية (أي نمط [Pattern] ذلك التعبير النمطي).

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

fun toString(): String

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

تعاد سلسلة نصية تمثل التعبير النمطي المعطى.

أمثلة

استعمال الدالة toString()‎ لتحويل تعبير نمطيّ إلى سلسلة نصية:

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

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

انظر أيضًا

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>Regex.toString()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>Regex.toString()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة<code>toString()‎</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>toString()‎</code> [[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًّا]] إلى [[Kotlin/String|سلسلة نصية]] (أي نمط [<code>[[Kotlin/kotlin.text/java.util.regex.Pattern/index|Pattern]]</code>] ذلك التعبير النمطي).
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-fun toPattern(): Pattern
+fun toString(): String
 </syntaxhighlight>
-==القيمة المُعادة==
+==القيمة المعادة==
-نسخة من الصنف <code>[[Kotlin/kotlin.text/java.util.regex.Pattern/index|Pattern]].</code>
+تعاد [[Kotlin/String|سلسلة نصية]] تمثل [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] المعطى.
 ==أمثلة==
-===استخدام التابع <code>toString()‎</code>===
+<nowiki/>استعمال الدالة <code>toString()‎</code> لتحويل [[Kotlin/kotlin.text/Regex/index|تعبير نمطيّ]] إلى [[Kotlin/String|سلسلة نصية]]:<syntaxhighlight lang="kotlin">
-ينشِئ التابع <code>[[Kotlin/kotlin.text/Regex/Init|Regex()]]‎</code> في الشيفرة الآتية <nowiki/>[[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] باسم <code>reg</code> لمطابقة التعابير العددية، ثم يستدعي عبره الدالة <code>toString()‎</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.toString()) // => -?\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/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/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.toString()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/to-string.html صفحة الدالة Regex.toString()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Methods]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin Regex]]