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

المراجعة الحالية بتاريخ 14:56، 30 أغسطس 2018

تمثل الخاصية Regex.options مجموعةَ الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعي معها.

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

actual val options: Set<RegexOption>

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

تعاد مجموعةٌ تحوي جميع الخيارات التي استعملت في ضبط التعبير النمطي المعطى أثناء إنشائه.

أمثلة

استعمال الخاصية options مع تعبير نمطي لمعرفة الخيارات التي استعملت في ضبطه عند إنشائه -باستعمال الدالة Regex()‎-:

fun main(args: Array<String>) {
  val reg = Regex("""-?\d+(\.\d+)?""", RegexOption.UNIX_LINES)
    
  print(reg.options) // [UNIX_LINES]
}

انظر أيضًا

الخاصية Regex.pattern: تمثل النمط الأولي الذي استُخدم في إنشاء التعبير النمطي الذي استُدعي معها.
الدالة Regex()‎: تنشئ تعبيرًا نمطيًا (regular expression) انطلاقًا من السلسلة النصية المُمرّرة إليه.
الدالة containsMatchIn()‎: تتحقق إن كان بإمكان التعبير النمطي الذي استُدعي معها مطابقة محرفٍ واحدٍ على الأقل من سلسلة المحارف المُمرّرة إليه.
الدالة replace()‎: تبدل سلسلة النصية معينة مكان كل تطابقات التعبير النمطي الذي استدعي معها في سلسلة المحارف المُمرّرة إليها أو سلسلة المحارف التي تعيدها الدالة الممررة إليها.
الدالة toString()‎: تحول تعبيرًا نمطيًّا إلى سلسلة نصية (أي نمط [Pattern] ذلك التعبير النمطي).

مصادر

صفحة الخاصية ‎Regex.options في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: صفحة <code>options‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الخاصية <code>Regex.options</code> في Kotlin}}</noinclude>
-تعيد الدالة<code>options‎</code> الحرف المقابل للقيمة العددية للعنصر الذي استُدعيت عبره، مُقتطعة (truncated) إلى 16 بتة إن كان ضروريًا<nowiki/><nowiki/>.
+<nowiki/><nowiki/>تمثل الخاصية <code>Regex.options</code> مجموعةَ الخيارات التي استُخدمت في إنشاء [[Kotlin/kotlin.text/Regex|التعبير النمطي]] الذي استُدعي معها.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-fun toChar(): Char
+actual val options: Set<RegexOption>
 </syntaxhighlight>
-==القيمة المُعادة==
+==القيمة المعادة==
-الحرف المقابل للقيمة العددية للعنصر الذي استُدعيت الدالة عبره.
+تعاد [[Kotlin/collection/Set|مجموعةٌ]] تحوي جميع الخيارات التي استعملت في ضبط [[Kotlin/kotlin.text/Regex|التعبير النمطي]] المعطى أثناء إنشائه.
 ==أمثلة==
-===استخدام الدالة <code>()toChar</code>===
+استعمال الخاصية <code>options</code> مع تعبير نمطي لمعرفة الخيارات التي استعملت في ضبطه عند إنشائه -باستعمال الدالة <code>[[Kotlin/kotlin.text/Regex/Init|Regex()‎]]</code>-:<syntaxhighlight lang="kotlin">
-تعرّف الشيفرة الآتية ثلاثة أعداد <nowiki/>باسم <code>x</code> و <code>y</code> و <code>z</code>، ثم تستخدم الدالة<code>()toChar</code> على تلك الأعداد، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+fun main(args: Array<String>) {
-fun main(args: Array<String>) {
+  val reg = Regex("""-?\d+(\.\d+)?""", RegexOption.UNIX_LINES)
-    val x : Float = 97.4f
-    val y : Float = 50.2f
-    val z : Float = 101.34f
-    println(x.toChar() )// a
+  print(reg.options) // [UNIX_LINES]
-    println(y.toChar() )// 2
-    println(z.toChar() )// e
 }
 </syntaxhighlight>
-==أنظر أيضًا==
+==انظر أيضًا==
-* <code>[[Kotlin/Float/toByte|toByte()]]</code>‎ : تحوّل قيمة العنصر الذي استُدعيت عبره إلى عدد من النوع <code>Byte</code>.
+*الخاصية <code>[[Kotlin/kotlin.text/Regex/pattern|Regex.pattern]]</code>: تمثل النمط الأولي الذي استُخدم في إنشاء [[Kotlin/kotlin.text/Regex|التعبير النمطي]] الذي استُدعي معها.
-* <code>[[Kotlin/Float/inc|inc()]]</code>‎ : ترفع قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
+*الدالة <code>[[Kotlin/kotlin.text/Regex/Init|Regex()‎]]</code>: تنشئ [[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] (regular expression) انطلاقًا من [[Kotlin/String|السلسلة النصية]] المُمرّرة إليه.
-* <code>[[Kotlin/Float/div|div()]]</code>‎ : تقوم  بقسمة العدد الذي استُدعيت عبره على العدد الممرّر.
+*الدالة <code>[[Kotlin/kotlin.text/Regex/containsMatchIn|containsMatchIn()‎]]</code>: تتحقق إن كان بإمكان [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعي معها مطابقة محرفٍ واحدٍ على الأقل من [[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليه.
-* <code>[[Kotlin/Float/inc|inc()]]</code>‎ : ترفع قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
+*الدالة <code>[[Kotlin/kotlin.text/Regex/replace|replace()‎]]</code>: تبدل سلسلة النصية معينة مكان كل تطابقات <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استدعي معها في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليها أو <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي تعيدها الدالة الممررة إليها.
+* الدالة <code>[[Kotlin/kotlin.text/Regex/toString|toString()‎]]</code>: تحول <nowiki/>[[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًّا]] إلى سلسلة نصية (أي نمط [<code>[[Kotlin/kotlin.text/java.util.regex.Pattern/index|Pattern]]</code>] ذلك التعبير النمطي).
 ==مصادر==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float/to-char.html صفحة ‎options في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/options.html صفحة الخاصية ‎Regex.options في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
+[[تصنيف:Kotlin Property]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin Regex]]