الفرق بين المراجعتين ل"Kotlin/kotlin.text/Regex/toString"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>Regex.toString()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>toString()‎</code> نسخة من...')
 
(مراجعة وتدقيق.)
 
(3 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 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">
 
<syntaxhighlight lang="kotlin">
fun toPattern(): Pattern
+
fun toString(): String
  
 
</syntaxhighlight>
 
</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>) {
 
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>
 
</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]]
[[تصنيف:Kotlin Methods]]
+
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin Text]]
 +
[[تصنيف:Kotlin Regex]]

المراجعة الحالية بتاريخ 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+)?
}

انظر أيضًا

مصادر