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

من موسوعة حسوب
ط استبدال النص - '==القيمة المُعادة==' ب'==القيمة المعادة=='
مراجعة وتدقيق.
 
(مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>Regex.toString()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>Regex.toString()‎</code> في Kotlin}}</noinclude>
تعيد الدالة<code>toString()‎</code> تمثيلًا نصيًا  [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استُدعيت عبره، أي [[Kotlin/kotlin.text/java.util.regex.Pattern/index|نمط]] (<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">
سطر 7: سطر 7:
</syntaxhighlight>
</syntaxhighlight>
==القيمة المعادة==
==القيمة المعادة==
[[Kotlin/String|سلسلة نصية.]]
تعاد [[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> لإعادة تمثيل نصي  [[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.toString()) // => -?\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-string.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+)?
}

انظر أيضًا

مصادر