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

مراجعة 18:25، 13 يوليو 2018

تحول الدالة toPattern()‎ السلسلة النصية التي استٌدعيت عبرها إلى تعبير نمطي. يمكن تمرير وسيط flags، لكي يتسنّى تقسيم أو مطابقة السلسلة النصية.

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

inline fun String.toPattern(flags: Int = 0): Pattern

بيئة التشغيل المطلوبة: JVM

يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).

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

كائن من النوع Pattern.

أمثلة

استخدام الدالة `toPattern()‎` مع السلاسل النصية

تستدعي الشيفرة الآتية الدالة toPattern()‎ عبر سلسلة نصية، وتطبع الناتج:

fun main(args: Array<String>) {
println("""-?\d+(\.\d+)?""".toPattern()) // يطابق هذا التعبير النمطي التعابير العددية، مثل: 45
}

انظر أيضًا

toDouble()‎ : تحلّل الدالة toDouble()‎ السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع Double وتعيد الناتج.

toUpperCase()‎ : تحوّل الدالة toUpperCase()‎ الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).

toBigDecimalOrNull()‎: تحلّل الدالة toBigDecimalOrNull()‎ السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع BigDecimal.
toBigDecimal()‎: تحلّل الدالة toBigDecimal()‎ السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع BigDecimal.

isDefined()‎: تعيد القيمة true في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: التابع text.toPattern()‎ في لغة Kotlin}}</noinclude>
-تعيد الدالة <code>toPattern()</code>‎ [[Kotlin/List|لائحة]] تحتوي كل حروف [[Kotlin/CharSequence/index|سلسلة الحروف]]  التي استٌدعيت عبرها.
+تحول الدالة <code>toPattern()</code>‎ [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها إلى [[Kotlin/kotlin.text/Regex/index|تعبير نمطي]]. يمكن تمرير وسيط <code>flags</code>، لكي يتسنّى تقسيم أو مطابقة [[Kotlin/String|السلسلة النصية]].
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-fun CharSequence.toList(): List<Char>
+inline fun String.toPattern(flags: Int = 0): Pattern
+</syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM'''
+يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
-</syntaxhighlight>
 ==القيم المعادة==
-[[Kotlin/List|لائحة]] من الحروف.
+كائن من النوع <code>[[Kotlin/kotlin.text/java.util.regex.Pattern/index|Pattern]]</code>.
 ==أمثلة==
 ===استخدام الدالة <code>toPattern()‎</code> مع السلاسل النصية===
-تستدعي الشيفرة الآتية الدالة <code>toPattern()‎</code> عبر عدة [[Kotlin/String|سلاسل نصية]]، وتطبع الناتج:<syntaxhighlight lang="kotlin">
+تستدعي الشيفرة الآتية الدالة <code>toPattern()‎</code> عبر [[Kotlin/String|سلسلة نصية]]، وتطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-    println("Hello, world!".toList()) // [H, e, l, l, o, ,,  , w, o, r, l, d, !]
+println("""-?\d+(\.\d+)?""".toPattern()) // يطابق هذا التعبير النمطي التعابير العددية، مثل: 45
-    println("Hsoub".toList()) // [H, s, o, u, b]
-    println("114".toList()) // [1, 1, 4]
 }
 </syntaxhighlight>
@@ سطر 28: / سطر 28: @@
 ==مصادر==
 <span> </span>
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-list.html صفحة الدالة text.toPattern()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-pattern.html صفحة الدالة text.toPattern()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Method]]