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