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

من موسوعة حسوب
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التهيئة الأولية <init> عبر التابع Regex.Init()‎ في لغة Kotlin}}</noinclude> ينشِئ التابع <code>Regex(...'
 
ط نقل جميل-بيلوني صفحة Kotlin/kotlin.text/Regex/Init إلى Kotlin/kotlin.text/Regex/init: السبب هو استعمال حرف كبير في العبارة Init بدلًا من الحرف الصغير "init" الذي يطابق...
 
(5 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التهيئة الأولية <init> عبر التابع Regex.Init()‎ في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: التهيئة الأولية <code><init></code> للصنف <code>Regex</code> في Kotlin}}</noinclude>
ينشِئ التابع <code>Regex()‎</code> مصفوفةً من النوع <code>FloatArray</code>  بحجم <code>size</code> مُحدَّدٍ، بحيث كل العناصر تساوي <code>0</code>، وفي حال  تمرير دالة كوسيط فسيُحسَب كلُّ عنصرٍ فيها عبر استدعاء الدالة <code>init</code> المُحدَّدة، والتي تُعيد عنصرًا في المصفوفة بحسب الفهرس (index) المُعطى.  
تنشئ الدالة <code>Regex()‎</code> [[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] (regular expression) انطلاقًا من [[Kotlin/String|السلسلة النصية]] المُمرّرة إليه.
 
==البنية العامة==
== البنية العامة ==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
FloatArray(size: Int, init: (Int) -> Float)
Regex(pattern: String)
FloatArray(size: Int)
Regex(pattern: String, option: RegexOption)
 
Regex(pattern: String, options: Set<RegexOption>)
</syntaxhighlight>
</syntaxhighlight>تنشئ الدالة <code>Regex()‎</code> [[Kotlin/kotlin.text/Regex|تعبيرًا نمطيًا]] من النمط <code>pattern</code> مع ضبطه وفقًا الخيار <code>option</code> أو مجموعة الخيارات <code>options</code> (أو القيمة الافتراضية لهذه الخيارات إن لم يعطَ الوسيط <code>option</code>) التي تضبط ذلك النمط.
 
== القيم المعادة ==
مصفوفة من النوع <code>FloatArray</code> بالحجم <code>size</code>.


== أمثلة ==
== المعاملات ==


=== استخدام التابع <code>FloatArray()‎</code> لإنشاء المصفوفة ===
=== <code>pattern</code> ===
ينشِئ التابع <code>FloatArray()‎</code> في الشيفرة الآتية مصفوفةً من ستة عناصر ، ثم تُطبَع عناصر المصفوفة:<syntaxhighlight lang="kotlin">
سلسلة نصية تمثل النمط الذي سينشأ منه [[Kotlin/kotlin.text/Regex|تعبير نمطي]].
import java.util.Arrays


fun main(args: Array<String>) {
=== <code>option</code> ===
val array = FloatArray(6)
كائن من النوع <code>[[KOtlin/kotlin.text/RegexOption|RegexOption]]</code> يحوي خيارًا واحدًا من خيارات التعابير النمطية.


print(Arrays.toString(array)) // [0.0, 0.0, 0.0, 0.0, 0.0, 0.0]
=== <code>options</code> ===
}
[[Kotlin/collections/Set|مجموعة]] تتألف من عدة كائنات من النوع <code>[[KOtlin/kotlin.text/RegexOption|RegexOption]]</code> تمثل خيارات التعابير النمطية.
</syntaxhighlight>
=== استخدام التابع <code>FloatArray()‎</code> لإنشاء المصفوفة مع تمرير دالة ===
ينشِئ التابع <code>FloatArray()‎</code> في الشيفرة الآتية مصفوفةً بستة عناصر  عبر تمرير الدالة المٌعرفة <code>f،</code>ثم تُطبَع عناصر المصفوفة:<syntaxhighlight lang="kotlin">
import java.util.Arrays


==القيم المعادة==
يعاد كائن من النوع <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 f: (Int) -> Float = { x -> x*4f }
    val reg = Regex("""-?\d+(\.\d+)?""")
val array = FloatArray(6, f)


print(Arrays.toString(array)) // [0.0, 4.0, 8.0, 12.0, 16.0, 20.0]
    print(reg.containsMatchIn("xabcdy")) // false
    print(reg.containsMatchIn("xabc22dy")) // true
}
}
</syntaxhighlight>
</syntaxhighlight>
== انظر أيضًا ==
==انظر أيضًا==
* صفحة الصنف <code>[[Kotlin/FloatArray/index|FloatArray]]</code>
*الدالة <code>[[Kotlin/kotlin.text/Regex/containsMatchIn|containsMatchIn()‎]]</code>: تتحقق إن كان بإمكان [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعي معها مطابقة محرفٍ واحدٍ على الأقل من [[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليه.
* الخاصيّة <code>[[Kotlin/FloatArray/size|FloatArray.size]]</code>: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
*الدالة <code>[[Kotlin/kotlin.text/Regex/findAll|findAll()‎]]</code>: تبحث عن جميع المحارف المتطابقة مع [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعي معها في [[Kotlin/CharSequence|سلسلة المحارف]] الممرَّرة إليها. يمكن البحث في [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
* [[Kotlin/classes|الأصناف والبواني (constructors) في لغة Kotlin.]]
*الدالة <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|سلسلة المحارف]] التي تعيدها الدالة الممررة إليها.
== مصادر ==
*الدالة <code>[[Kotlin/kotlin.text/Regex/split|split()‎]]</code>: تقتطع المحارف الموجودة بين الأجزاء المتطابقة مع <nowiki/>[[Kotlin/kotlin.text/Regex|التعبير النمطي]] الذي استُدعي معها في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] الممررة إليها.
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float-array/-init-.html التهيئة الأوليّة عبر التابع Regex.Array()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*الدالة <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»