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

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

تحول الدالة toPattern()‎ السلسلة النصية التي استٌدعيت معها إلى نمط.

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

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

منصة التشغيل المطلوبة: JVM.

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

المعاملات

`flags`

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

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

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

أمثلة

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

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

انظر أيضًا

الدالة toBoolean()‎: تعيد القيمة true إن كانت السلسلة النصية التي استٌدعيت معها تساوي "true" مع تجاهل حالة الأحرف، أو تعيد القيمة false.
الدالة toByte()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد من النوع Byte.
الدالة toByteArray()‎: ترمز جميع محارف السلسلة النصية التي استٌدعيت معها وفقًا لترميز محدد ثم تضع الناتج في مصفوفة من النوع ByteArray.
الدالة toUpperCase()‎ : تحوّل المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف كبيرة (uppercase).
الدالة toCharArray()‎: تضع جميع محارف السلسلة النصية التي استٌدعيت معها في مصفوفة من النوع CharArray، إذ يوضع كل محرف في عنصر.
الدالة toCollection()‎: تضيف كل محارف السلسلة التي استٌدعيت معها إلى المجموعة المتغيرة المُمرّرة إليها.
الدالة toHashSet()‎: تحلّل كائنًا من النوع HashSet يحوي كل محارف السلسلة التي استٌدعيت معها.
الدالة toInt()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح.
الدالة toLowerCase()‎: تحول المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف صغيرة (lowercase).
الدالة toMutableList()‎: تضيف كل محارف سلسلة المحارف التي استٌدعيت معها إلى قائمة متغيرة، إذ يوضع كل محرف في عنصر.
الدالة toRegex()‎: تحول السلسلة النصية التي استٌدعيت معها إلى تعبير نمطي (regular expression).
الدالة toSet()‎: تضيف كل محارف سلسلة الحروف التي استٌدعيت معها إلى مجموعة من النوع Set، إذ يوضع كل محرف في عنصر.
الدالة toUpperCase()‎: تحول المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف كبيرة (uppercase).

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع text.toPattern()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE:الدالة <code>toPattern()‎</code> في Kotlin}}</noinclude>
-تحول الدالة <code>toPattern()</code>‎ [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها إلى [[Kotlin/kotlin.text/Regex/index|تعبير نمطي]]. يمكن تمرير وسيط <code>flags</code>، لكي يتسنّى تقسيم أو مطابقة [[Kotlin/String|السلسلة النصية]].
+تحول الدالة <code>toPattern()</code>‎ [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها إلى نمط.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
 inline fun String.toPattern(flags: Int = 0): Pattern
-</syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM'''
+</syntaxhighlight>'''منصة التشغيل المطلوبة:''' JVM.
-يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
+== المعاملات ==
+=== <code>flags</code> ===
+عدد صحيح يستعمل لتقسيم أو مطابقة [[Kotlin/String|السلسلة النصية]] المعطاة.
 ==القيم المعادة==
-كائن من النوع <code>[[Kotlin/kotlin.text/java.util.regex.Pattern/index|Pattern]]</code>.
+يعاد كائن من النوع <code>[[Kotlin/kotlin.text/java.util.regex.Pattern/index|Pattern]]</code>.
 ==أمثلة==
-===استخدام الدالة <code>toPattern()‎</code> مع السلاسل النصية===
+مثالٌ على استعمال الدالة <code>toPattern()‎</code>:<syntaxhighlight lang="kotlin">
-تستدعي الشيفرة الآتية الدالة <code>toPattern()‎</code> عبر [[Kotlin/String|سلسلة نصية]]، وتطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-println("""-?\d+(\.\d+)?""".toPattern()) // يطابق هذا التعبير النمطي التعابير العددية، مثل: 45
+    println("""-?\d+(\.\d+)?""".toPattern()) // -?\d+(\.\d+)?
+    // يطابق هذا التعبير النمطي القيم العددية
 }
 </syntaxhighlight>
 ==انظر أيضًا==
-* <code>[[Kotlin/kotlin.text/toDouble|toDouble()]]</code>‎ : تحلّل الدالة <code>toDouble()</code>‎ السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>Double</code> وتعيد الناتج.
+*الدالة [[Kotlin/kotlin.text/toBoolean|<code>toBoolean()</code>‎]]: تعيد القيمة <code>true</code> إن كانت [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها تساوي <code>"true"</code> مع تجاهل حالة الأحرف، أو تعيد القيمة <code>false</code>.
+*الدالة [[Kotlin/kotlin.text/toByte|<code>toByte()</code>‎]]: تحلّل [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها وتحوّلها إلى عدد من النوع <code>[[Kotlin/Byte|Byte]]</code>.
-*<code>[[Kotlin/text/toUpperCase|toUpperCase()]]</code>‎ : تحوّل الدالة <code>toUpperCase()</code>‎ الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).
+*الدالة [[Kotlin/kotlin.text/toByteArray|<code>toByteArray()</code>‎]]: ترمز جميع محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها وفقًا لترميز محدد ثم تضع الناتج في مصفوفة من النوع <code>[[Kotlin/ByteArray|ByteArray]]</code>.
+*الدالة <code>[[Kotlin/text/toUpperCase|toUpperCase()]]</code>‎ : تحوّل المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف كبيرة (uppercase).
-*<code>[[Kotlin/text/isDefined|toBigDecimalOrNull()]]‎</code>: تحلّل الدالة <code>toBigDecimalOrNull()</code>‎ [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>BigDecimal</code>.
+*الدالة [[Kotlin/kotlin.text/toCharArray|<code>toCharArray()</code>‎]]: تضع جميع محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها في مصفوفة من النوع <code>[[Kotlin/CharArray|CharArray]]</code>، إذ يوضع كل محرف في عنصر.
-*<code>[[Kotlin/kotlin.text/toBigDecimal|toBigDecimal()]]‎</code>: تحلّل الدالة <code>toBigDecimal()</code>‎ [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>BigDecimal</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|السلسلة]] التي استٌدعيت معها.
+* الدالة <nowiki/>[[Kotlin/kotlin.text/toInt|<code>toInt()</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/toRegex|<code>toRegex()</code>‎]]: تحول [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها إلى [[Kotlin/kotlin.text/Regex/index|تعبير نمطي]] (regular expression).
+* الدالة [[Kotlin/kotlin.text/toSet|<code>toSet()</code>‎]]: تضيف كل محارف [[Kotlin/CharSequence/index|سلسلة الحروف]]  التي استٌدعيت معها إلى مجموعة من النوع <code>[[Kotlin/Set|Set]]</code>، إذ يوضع كل محرف في عنصر.
+* الدالة [[Kotlin/text/toUpperCase|<code>toUpperCase()</code>‎]]: تحول [[Kotlin/Char|المحرف]] أو جميع محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها إلى محارف كبيرة (uppercase).
-*<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-pattern.html صفحة الدالة toPattern()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-pattern.html صفحة الدالة text.toPattern()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]