الفرق بين المراجعتين ل"Kotlin/kotlin.text/Regex/init"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط (نقل جميل-بيلوني صفحة Kotlin/kotlin.text/Regex/Init إلى Kotlin/kotlin.text/Regex/init: السبب هو استعمال حرف كبير في العبارة Init بدلًا من الحرف الصغير "init" الذي يطابق...)
 
(4 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
−
<noinclude>{{DISPLAYTITLE: التهيئة الأولية <init> عبر التابع Regex.Init()‎ في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: التهيئة الأولية <code><init></code> للصنف <code>Regex</code> في Kotlin}}</noinclude>
−
ينشِئ التابع <code>Regex()‎</code> [[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] (regular expression) انطلاقًا من [[Kotlin/String|السلسلة النصية]] المُمرّرة والوسائط الابتدائية.   
+
تنشئ الدالة <code>Regex()‎</code> [[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] (regular expression) انطلاقًا من [[Kotlin/String|السلسلة النصية]] المُمرّرة إليه.   
−
 
+
==البنية العامة==
−
== البنية العامة ==
 
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
 
Regex(pattern: String)
 
Regex(pattern: String)
−
 
−
</syntaxhighlight>ينشِئ التابع <code>Regex()‎</code> [[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] (regular expression) انطلاقًا من [[Kotlin/String|السلسلة النصية]] المُمرّرة والوسائط الابتدائية. <syntaxhighlight lang="kotlin">
 
 
Regex(pattern: String, option: RegexOption)
 
Regex(pattern: String, option: RegexOption)
 
Regex(pattern: String, options: Set<RegexOption>)
 
Regex(pattern: String, options: Set<RegexOption>)
 +
</syntaxhighlight>تنشئ الدالة <code>Regex()‎</code> [[Kotlin/kotlin.text/Regex|تعبيرًا نمطيًا]] من النمط <code>pattern</code> مع ضبطه وفقًا الخيار <code>option</code> أو مجموعة الخيارات <code>options</code> (أو القيمة الافتراضية لهذه الخيارات إن لم يعطَ الوسيط <code>option</code>) التي تضبط ذلك النمط.
  
−
</syntaxhighlight>ينشِئ التابع <code>Regex()‎</code> [[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] (regular expression) انطلاقًا من [[Kotlin/String|السلسلة النصية]] المُمرّرة ومن  الوسيط المُمرر <code>options</code>.
+
== المعاملات ==
  
−
== القيم المعادة ==
+
=== <code>pattern</code> ===
−
[[Kotlin/kotlin.text/Regex/index|تعبير نمطي]] (regular expression).
+
سلسلة نصية تمثل النمط الذي سينشأ منه [[Kotlin/kotlin.text/Regex|تعبير نمطي]].
  
−
== أمثلة ==
+
=== <code>option</code> ===
 +
كائن من النوع <code>[[KOtlin/kotlin.text/RegexOption|RegexOption]]</code> يحوي خيارًا واحدًا من خيارات التعابير النمطية.
  
−
=== استخدام التابع <code>Regex()‎</code> لإنشاء تعبير نمطي ===
+
=== <code>options</code> ===
−
ينشِئ التابع <code>Regex()‎</code> في الشيفرة الآتية [[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] باسم <code>reg</code> ، ثم يجربه باستخدام الدالة <code>[[Kotlin/kotlin.text/Regex/containsMatchIn|containsMatchIn()]]‎</code> :<syntaxhighlight lang="kotlin">
+
[[Kotlin/collections/Set|مجموعة]] تتألف من عدة كائنات من النوع <code>[[KOtlin/kotlin.text/RegexOption|RegexOption]]</code> تمثل خيارات التعابير النمطية.
 +
 
 +
==القيم المعادة==
 +
يعاد كائن من النوع <code>[[Kotlin/kotlin.text/Regex|Regex]]</code> يحتوي على التعبير النمطي <code>pattern</code> بعد ضبطه وفقًا للخيار <code>option</code> أو مجموعة الخيارات <code>options</code> المعطاة أو القيمة الافتراضية لها (إن لم يُعطَ أي خيار).
 +
==أمثلة==
 +
ينشِئ التابع <code>Regex()‎</code> في الشيفرة التالية [[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] باسم <code>reg</code> ثم يطابق سلسلةً نصيةً معه باستخدام الدالة <code>[[Kotlin/kotlin.text/Regex/containsMatchIn|containsMatchIn()]]‎</code>:<syntaxhighlight lang="kotlin">
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
−
  val reg = Regex("""-?\d+(\.\d+)?""")
+
    val reg = Regex("""-?\d+(\.\d+)?""")
−
      
+
 
−
  print(reg.containsMatchIn("xabcdy")) // false
+
     print(reg.containsMatchIn("xabcdy")) // false
−
  print(reg.containsMatchIn("xabc22dy")) // true
+
    print(reg.containsMatchIn("xabc22dy")) // true
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
−
=== انظر أيضًا ===
+
==انظر أيضًا==
−
* صفحة <code>[[Kotlin/kotlin.text/Regex/index|Regex]]</code>[[Kotlin/kotlin.text/Regex/index|.]]
+
*الدالة <code>[[Kotlin/kotlin.text/Regex/containsMatchIn|containsMatchIn()‎]]</code>: تتحقق إن كان بإمكان [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعي معها مطابقة محرفٍ واحدٍ على الأقل من [[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليه.
−
* [[Kotlin/classes|الأصناف والبواني (constructors) في لغة Kotlin.]]
+
*الدالة <code>[[Kotlin/kotlin.text/Regex/findAll|findAll()‎]]</code>: تبحث عن جميع المحارف المتطابقة مع [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعي معها في [[Kotlin/CharSequence|سلسلة المحارف]] الممرَّرة إليها. يمكن البحث في [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
−
 
+
*الدالة <code>[[Kotlin/kotlin.text/Regex/matchEntire|matchEntire()‎]]</code>: تحاول مطابقة جميع محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] الممررة إليها مع <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استدعي معها.
−
== مصادر ==
+
*الدالة <code>[[Kotlin/kotlin.text/Regex/replace|replace()‎]]</code>: تبدل سلسلة النصية معينة مكان كل تطابقات <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استدعي معها في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليها أو <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي تعيدها الدالة الممررة إليها.
−
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/-init-.html التهيئة الأوليّة عبر التابع Regex.Init()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
*الدالة <code>[[Kotlin/kotlin.text/Regex/split|split()‎]]</code>: تقتطع المحارف الموجودة بين الأجزاء المتطابقة مع <nowiki/>[[Kotlin/kotlin.text/Regex|التعبير النمطي]] الذي استُدعي معها في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] الممررة إليها.
 +
*الدالة <code>[[Kotlin/kotlin.text/Regex/toPattern|toPattern()‎]]</code>: تحول كائنًا من النوع <code>[[Kotlin/kotlin.text/Regex|Regex]]</code> (تعبيرًا نمطيًا) إلى النوع <code>[[Kotlin/kotlin.text/java.util.regex.Pattern/index|Pattern]]</code> (نمط).
 +
*الخاصية <code>[[Kotlin/kotlin.text/Regex/options|Regex.options]]</code>: تمثل مجموعةَ الخيارات التي استُخدمت في إنشاء [[Kotlin/kotlin.text/Regex|التعبير النمطي]] الذي استُدعي معها.
 +
*الخاصية <code>[[Kotlin/kotlin.text/Regex/pattern|Regex.pattern]]</code>: تمثل النمط الأولي الذي استُخدم في إنشاء [[Kotlin/kotlin.text/Regex|التعبير النمطي]] الذي استُدعي معها.
 +
*[[Kotlin/classes|الأصناف والبواني (constructors) في لغة Kotlin.]]
 +
==مصادر==
 +
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/-init-.html صفحة <init> للصنف Regex في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
−
[[تصنيف:Kotlin Method]]
+
[[تصنيف:Kotlin init]]
 +
[[تصنيف:Kotlin Text]]
 +
[[تصنيف:Kotlin Regex]]

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

تنشئ الدالة Regex()‎ تعبيرًا نمطيًا (regular expression) انطلاقًا من السلسلة النصية المُمرّرة إليه.

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

Regex(pattern: String)
Regex(pattern: String, option: RegexOption)
Regex(pattern: String, options: Set<RegexOption>)

تنشئ الدالة Regex()‎ تعبيرًا نمطيًا من النمط pattern مع ضبطه وفقًا الخيار option أو مجموعة الخيارات options (أو القيمة الافتراضية لهذه الخيارات إن لم يعطَ الوسيط option) التي تضبط ذلك النمط.

المعاملات

pattern

سلسلة نصية تمثل النمط الذي سينشأ منه تعبير نمطي.

option

كائن من النوع RegexOption يحوي خيارًا واحدًا من خيارات التعابير النمطية.

options

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

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

يعاد كائن من النوع Regex يحتوي على التعبير النمطي pattern بعد ضبطه وفقًا للخيار option أو مجموعة الخيارات options المعطاة أو القيمة الافتراضية لها (إن لم يُعطَ أي خيار).

أمثلة

ينشِئ التابع Regex()‎ في الشيفرة التالية تعبيرًا نمطيًا باسم reg ثم يطابق سلسلةً نصيةً معه باستخدام الدالة containsMatchIn()‎:

fun main(args: Array<String>) {
    val reg = Regex("""-?\d+(\.\d+)?""")

    print(reg.containsMatchIn("xabcdy")) // false
    print(reg.containsMatchIn("xabc22dy")) // true
}

انظر أيضًا

مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=Kotlin/kotlin.text/Regex/init&oldid=16171"