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

من موسوعة حسوب
→ التعديل السابقالتعديل اللاحق ←
مرئينص الويكي
لا ملخص تعديل
مراجعة وتدقيق.
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التهيئة الأولية <init> عبر التابع Regex.Init()‎ في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: التهيئة الأولية <init> للصنف Regex في 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|السلسلة النصية]] المُمرّرة والقيمة الابتداية للوسيط <code>options</code>. <syntaxhighlight lang="kotlin">
Regex(pattern: String, option: RegexOption)
Regex(pattern: String, option: RegexOption)
</syntaxhighlight>ينشِئ التابع <code>Regex()‎</code> [[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] (regular expression) انطلاقًا من [[Kotlin/String|السلسلة النصية]] المُمرّرة ومن  الوسيط المُمرر <code>option</code>.<syntaxhighlight lang="kotlin">
Regex(pattern: String, options: Set<RegexOption>)
Regex(pattern: String, options: Set<RegexOption>)
 
</syntaxhighlight>تنشئ الدالة <code>Regex()‎</code> [[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] من النمط <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>.
 
== القيم المعادة ==
== القيم المعادة ==
[[Kotlin/kotlin.text/Regex/index|تعبير نمطي]] (regular expression).
يعاد كائن من النوع <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>) {
    val reg = Regex("""-?\d+(\.\d+)?""")


=== استخدام التابع <code>Regex()‎</code> لإنشاء تعبير نمطي ===
     print(reg.containsMatchIn("xabcdy")) // false
ينشِئ التابع <code>Regex()‎</code> في الشيفرة الآتية [[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] باسم <code>reg</code> ، ثم يجربه باستخدام الدالة  <code>[[Kotlin/kotlin.text/Regex/containsMatchIn|containsMatchIn()]]‎</code> :<syntaxhighlight lang="kotlin">
    print(reg.containsMatchIn("xabc22dy")) // true
fun main(args: Array<String>) {
  val reg = Regex("""-?\d+(\.\d+)?""")
      
  print(reg.containsMatchIn("xabcdy")) // false
  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/options|Regex.options]]</code>: تمثل مجموعةَ الخيارات التي استُخدمت في إنشاء [[Kotlin/kotlin.text/Regex|التعبير النمطي]] الذي استُدعي معها.
* الخاصية <code>[[Kotlin/kotlin.text/Regex/pattern|Regex.pattern]]</code>: النمط الأولي الذي استُخدم في إنشاء [[Kotlin/kotlin.text/Regex|التعبير النمطي]] الذي استُدعي معها.
* الدالة <code>[[Kotlin/kotlin.text/Regex/containsMatchIn|containsMatchIn()‎]]</code>: تتحقق إن كان بإمكان [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعي معها مطابقة محرفٍ واحدٍ على الأقل من [[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليه.
* الدالة <code>[[Kotlin/kotlin.text/Regex/find|find()‎]]</code>: تبحث عن أول محرف متطابق مع [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعي معها في [[Kotlin/CharSequence|سلسلة المحارف]] الممرَّرة إليها. يمكن البحث في [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
* الدالة <code>[[Kotlin/kotlin.text/Regex/findAll|findAll()‎]]</code>: تبحث عن جميع المحارف المتطابقة مع [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعي معها في [[Kotlin/CharSequence|سلسلة المحارف]] الممرَّرة إليها. يمكن البحث في [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
* [[Kotlin/classes|الأصناف والبواني (constructors) في لغة Kotlin.]]
* [[Kotlin/classes|الأصناف والبواني (constructors) في لغة Kotlin.]]


== مصادر ==
== مصادر ==
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/-init-.html التهيئة الأوليّة عبر التابع Regex.Init()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة 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]]

مراجعة 09:02، 30 أغسطس 2018

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

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

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

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

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

يعاد كائن من النوع 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=15787»