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

المراجعة الحالية بتاريخ 11:18، 6 سبتمبر 2018

تحول الدالة toRegex()‎ السلسلة النصية التي استٌدعيت معها إلى تعبير نمطي (regular expression).

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

inline fun String.toRegex(): Regex 
inline fun String.toRegex(option: RegexOption): Regex
inline fun String.toRegex(options: Set<RegexOption>): Regex

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

المعاملات

`option`

كائن من النوع RegexOption يمثل الخيارات التي ستستعمل في ضبط التعبير النمطي عند التحويل.

`options`

مجموعة تحوي كائنات من النوع RegexOption يمثل الخيارات التي ستستعمل في ضبط التعبير النمطي عند التحويل.

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

يعاد تعبير نمطي ناتج عن تحويل السلسلة النصية المعطاة.

أمثلة

مثالٌ على استعمال الدالة toRegex()‎:

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

انظر أيضًا

الدالة toCollection()‎: تضيف كل محارف السلسلة التي استٌدعيت معها إلى المجموعة المتغيرة المُمرّرة إليها.
الدالة toHashSet()‎: تحلّل كائنًا من النوع HashSet يحوي كل محارف السلسلة التي استٌدعيت معها.
الدالة toList()‎: تضيف كل محارف سلسلة المحارف التي استٌدعيت معها إلى قائمة، إذ يوضع كل محرف في عنصر.
الدالة toLong()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد طويل.
الدالة toLongOrNull()‎: تحلّل السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد طويل.
الدالة toLowerCase()‎: تحول المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف صغيرة (lowercase).
الدالة toMutableList()‎: تضيف كل محارف سلسلة المحارف التي استٌدعيت معها إلى قائمة متغيرة، إذ يوضع كل محرف في عنصر.
الدالة toPattern()‎: تحول السلسلة النصية التي استٌدعيت معها إلى نمط.
الدالة toSet()‎: تضيف كل محارف سلسلة الحروف التي استٌدعيت معها إلى مجموعة من النوع Set، إذ يوضع كل محرف في عنصر.
الدالة toShort()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد قصير.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع text.toRegex()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE:الدالة <code>toRegex()‎</code> في Kotlin}}</noinclude>
-تحول الدالة <code>toRegex()</code>‎ [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها إلى [[Kotlin/kotlin.text/Regex/index|تعبير نمطي]]. يمكن تمرير وسيط <code>flags</code>، لكي يتسنّى تقسيم أو مطابقة [[Kotlin/String|السلسلة النصية]].
+تحول الدالة <code>toRegex()</code>‎ [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها إلى [[Kotlin/kotlin.text/Regex/index|تعبير نمطي]] (regular expression).
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-inline fun String.toPattern(flags: Int = 0): Pattern
+inline fun String.toRegex(): Regex
-</syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM'''
+inline fun String.toRegex(option: RegexOption): Regex
+inline fun String.toRegex(options: Set<RegexOption>): Regex
-يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
+== المعاملات ==
+=== <code>option</code> ===
+كائن من النوع <code>RegexOption</code> يمثل الخيارات التي ستستعمل في ضبط التعبير النمطي عند التحويل.
+=== <code>options</code> ===
+[[Kotlin/collections/Set|مجموعة]] تحوي كائنات من النوع <code>RegexOption</code> يمثل الخيارات التي ستستعمل في ضبط التعبير النمطي عند التحويل.
 ==القيم المعادة==
-كائن من النوع <code>[[Kotlin/kotlin.text/java.util.regex.Pattern/index|Pattern]]</code>.
+يعاد [[Kotlin/kotlin.text/Regex/index|تعبير نمطي]] ناتج عن تحويل [[Kotlin/String|السلسلة النصية]] المعطاة.
 ==أمثلة==
-===استخدام الدالة <code>toRegex()‎</code> مع السلاسل النصية===
+مثالٌ على استعمال الدالة <code>toRegex()‎</code>:<syntaxhighlight lang="kotlin">
-تستدعي الشيفرة الآتية الدالة <code>toRegex()‎</code> عبر [[Kotlin/String|سلسلة نصية]]، وتطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-println("""-?\d+(\.\d+)?""".toPattern()) // يطابق هذا التعبير النمطي التعابير العددية، مثل: 45
+    println("""-?\d+(\.\d+)?""".toRegex()) // -?\d+(\.\d+)?
+    // يطابق هذا التعبير النمطي القيم العددية
 }
 </syntaxhighlight>
 ==انظر أيضًا==
-* <code>[[Kotlin/kotlin.text/toDouble|toDouble()]]</code>‎ : تحلّل الدالة <code>toDouble()</code>‎ السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>Double</code> وتعيد الناتج.
+*الدالة <nowiki/>[[Kotlin/kotlin.text/toCollection|<code>toCollection()</code>‎]]: تضيف كل محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استٌدعيت معها إلى المجموعة المتغيرة المُمرّرة إليها.
+* الدالة <nowiki/>[[Kotlin/kotlin.text/toHashSet|<code>toHashSet()</code>‎]]: تحلّل كائنًا من النوع <code>HashSet</code> يحوي كل محارف <nowiki/>[[Kotlin/CharSequence/index|السلسلة]] التي استٌدعيت معها.
-*<code>[[Kotlin/text/toUpperCase|toUpperCase()]]</code>‎ : تحوّل الدالة <code>toUpperCase()</code>‎ الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).
+* الدالة [[Kotlin/kotlin.text/toList|<code>toList()</code>‎]]: تضيف كل محارف [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها إلى [[Kotlin/collections/List|قائمة]]، إذ يوضع كل محرف في عنصر.
+* الدالة <code>[[Kotlin/kotlin.text/toLong|toLong()]]</code>‎: تحلّل [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها وتحوّلها إلى [[Kotlin/Long|عدد طويل]].
-*<code>[[Kotlin/text/isDefined|toBigDecimalOrNull()]]‎</code>: تحلّل الدالة <code>toBigDecimalOrNull()</code>‎ [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>BigDecimal</code>.
+* الدالة [[Kotlin/kotlin.text/toLongOrNull|<code>toLongOrNull()</code>‎]]: تحلّل [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى [[Kotlin/Long|عدد طويل]].
-*<code>[[Kotlin/kotlin.text/toBigDecimal|toBigDecimal()]]‎</code>: تحلّل الدالة <code>toBigDecimal()</code>‎ [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>BigDecimal</code>.
+* الدالة [[Kotlin/text/toLowerCase|<code>toLowerCase()</code>‎]]: تحول [[Kotlin/Char|المحرف]] أو جميع محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها إلى محارف صغيرة (lowercase).
+* الدالة [[Kotlin/kotlin.text/toMutableList|<code>toMutableList()</code>‎]]: تضيف كل محارف [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها إلى [[Kotlin/collections/List|قائمة متغيرة]]، إذ يوضع كل محرف في عنصر.
+* الدالة [[Kotlin/kotlin.text/toPattern|<code>toPattern()</code>‎]]: تحول [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها إلى نمط.
+* الدالة [[Kotlin/kotlin.text/toSet|<code>toSet()</code>‎]]: تضيف كل محارف [[Kotlin/CharSequence/index|سلسلة الحروف]]  التي استٌدعيت معها إلى مجموعة من النوع <code>[[Kotlin/Set|Set]]</code>، إذ يوضع كل محرف في عنصر.
+* الدالة [[Kotlin/kotlin.text/toShort|<code>toShort()</code>‎]]: تحلّل [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها وتحوّلها إلى [[Kotlin/Short|عدد قصير.]]
-*<code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
 ==مصادر==
-<span> </span>
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-regex.html صفحة الدالة toRegex()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-pattern.html صفحة الدالة text.toRegex()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]