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

من موسوعة حسوب
لا ملخص تعديل
مراجعة وتدقيق.
 
(1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:الصنف <code>‎‎MatchResult</code>‎ في Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE:الواجهة <code>‎‎MatchResult</code>‎ في Kotlin}}</noinclude>
تمثل نتيجة مطابقة واحدة [[Kotlin/kotlin.text/Regex/index|لتعبير نمطي]].
تمثل الواجهة <code>MatchResult</code> نتائج مطابقة واحدة [[Kotlin/kotlin.text/Regex/index|لتعبير نمطي]].<syntaxhighlight lang="kotlin">
 
interface MatchResult
== الأنواع ==
</syntaxhighlight>
 
==الأنواع==
===<code>[[Kotlin/kotlin.text/MatchResult/Destructured/index|Destructured]]</code>===
===<code>[[Kotlin/kotlin.text/MatchResult/Destructured/index|Destructured]]</code>===
يوفر مركبات التعيين التفكيكي (destructuring assignment) لمجموعة من القيم.
يوفر هذا الصنف مركبات الإسناد بالتفكيك (destructuring assignment) لمجموعة من القيم.
 
==الخاصيات==
== الخاصيات ==
 
===<code>[[Kotlin/kotlin.text/MatchResult/destructured|destructured‎]]</code>===
===<code>[[Kotlin/kotlin.text/MatchResult/destructured|destructured‎]]</code>===
الخاصية <code>destructured‎</code> تعيد نسخة من الصنف <code>[[Kotlin/kotlin.text/MatchResult/Destructured/index|MatchResult.Destructured]]،</code> والتي توفّر مركبات لتفكيك قيم المجموعة المُطابقة. المركبة الأولى تقابل قيمة المجموعة المُطابقَة الأولى، والمركبة الثانية تقابل الثانية، وهكذا دواليك.
تمثل هذه الخاصية نسخةً من الصنف <code>[[Kotlin/kotlin.text/MatchResult/Destructured|Destructured]]</code> توفّر مكونات عملية الإسناد بالتفكيك (destructuring assignment) التي تطبق على قيم المجموعة المُطابقة.
 
===<code>[[Kotlin/kotlin.text/MatchResult/groupValues|groupValues]]</code>===
===<code>[[Kotlin/kotlin.text/MatchResult/groupValues|groupValues]]</code>===
تعيد الخاصية <code>groupValues</code> لائحة تضم مجموعة المُطابقات  <nowiki/>[[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]]. حجم تلك اللائحة يساوي <code>groupCount + 1،</code> حيث<code>groupCount</code>هو عدد المجموعات المطابَقة في  <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]]. تلك المجموعات مُفهرسة من 1 حتى <code>groupCount،</code> والمجموعة ذات الفهرس <code>0</code> توافق المطابقة الكلية.
تمثل هذه الخاصية قائمة بقيم المجموعة المفهرسة المتطابقة.


===<code>[[Kotlin/kotlin.text/MatchResult/groups|groups]]</code>===
===<code>[[Kotlin/kotlin.text/MatchResult/groups|groups]]</code>===
تعيد الخاصية <code>groups</code> كائنًا من النوع <code>[[Kotlin/kotlin.text/MatchGroupCollection/index|MatchGroupCollection]]</code> يضم مجموعة المُطابقات الموجودة في <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]]. حجم تلك المجموعة يساوي<code>groupCount + 1،</code> حيث<code>groupCount</code> هو عدد المجموعات المطابَقة في  <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]]. تلك المجموعات مُفهرسة من 1 حتى <code>groupCount،</code>والمجموعة ذات الفهرس <code>0</code> توافق المطابقة الكلية.
تمثل هذه الخاصية [[Kotlin/collections|مجموعةً]] (collection) تضم جميع المجموعات (groups) المتطابقة باستعمال <nowiki/>[[Kotlin/kotlin.text/Regex/index|تعبير نمطي]] محدد.


===<code>[[Kotlin/kotlin.text/MatchResult/range|range]]</code>===
===<code>[[Kotlin/kotlin.text/MatchResult/range|range]]</code>===
تعيد الخاصية <code>range</code> مجال الفهارس الذي يحدد مكان مُطابقة <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]].
تمثل هذه الخاصية مجال الفهارس الذي يحدد مكان مُطابقة <nowiki/>[[Kotlin/kotlin.text/Regex/index|تعبير نمطي]] محدد في السلسلة النصية الأصلية.


===<code>[[Kotlin/kotlin.text/MatchResult/value|value]]</code>===
===<code>[[Kotlin/kotlin.text/MatchResult/value|value]]</code>===
تعيد الخاصية <code>value</code> جزء من السلسلة النصية المُدخلة والمُطابقة <nowiki/>[[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]].
تمثل هذه الخاصية السلسلة النصية المُدخلة، أو جزءًا منها، والمُطابقة <nowiki/>[[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]].
 
== الدوال ==


==الدوال==
===<code>[[Kotlin/kotlin.text/MatchResult/next|next]]</code>===
===<code>[[Kotlin/kotlin.text/MatchResult/next|next]]</code>===
تعيد الدالة<code>next()‎</code> كائنًا من النوع <code>[[Kotlin/kotlin.text/MatchResult/index|MatchResult]]</code> يحتوي نتائج المطابقة الموالية <nowiki/>[[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]]، بداية من فهرس آخر مطابقة.
تعيد هذه الدالة كائنًا من النوع <code>[[Kotlin/kotlin.text/MatchResult/index|MatchResult]]</code> يحوي ناتج المطابقة التالية [[Kotlin/kotlin.text/Regex/index|لتعبير نمطي]] محدد والذي يبدأ عند الفهرس الذي انتهت عنده آخر عملية مطابقة.
 
==الدوال الموروثة (Inherited Functions)==
== الدوال الموروثة (Inherited Functions) ==
===<code>[[Kotlin/Any/equals|equals]]</code>===
 
تتحقق هذه الدالة إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت عبره. 
=== <code>[[Kotlin/Any/equals|equals]]</code> ===
===<code>[[Kotlin/Any/hashCode|hashCode]]</code>===
تبين الدالة <code>equals()</code>‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت عبره.
تعيد هذه الدالة الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها.
 
===<code>[[Kotlin/Any/toString|toString]]</code>===
=== <code>[[Kotlin/Any/hashCode|hashCode]]</code> ===
تحول هذه الدالة الكائن الذي يُستدعى معه إلى سلسلة نصية (String).
يعيد التابع <code>hashCode()</code>‎ قيمة الشيفرة hash code الخاصّة بالكائن الذي استُدعي عبره.


=== <code>[[Kotlin/Any/toString|toString]]</code> ===
== مصادر ==
يعيد التابع <code>toString()‎</code> تمثيلًا نصيًا للكائن الذي يُستدعى عبره.
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-match-result/index.html?q=&p=0 صفحة الواجهة MatchResult في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Classes]]
[[تصنيف:Kotlin Interface]]
[[تصنيف:Kotlin Text]]
[[تصنيف:Kotlin MatchResult]]
[[تصنيف:Kotlin MatchResult]]

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

تمثل الواجهة MatchResult نتائج مطابقة واحدة لتعبير نمطي.

interface MatchResult

الأنواع

Destructured

يوفر هذا الصنف مركبات الإسناد بالتفكيك (destructuring assignment) لمجموعة من القيم.

الخاصيات

destructured‎

تمثل هذه الخاصية نسخةً من الصنف Destructured توفّر مكونات عملية الإسناد بالتفكيك (destructuring assignment) التي تطبق على قيم المجموعة المُطابقة.

groupValues

تمثل هذه الخاصية قائمة بقيم المجموعة المفهرسة المتطابقة.

groups

تمثل هذه الخاصية مجموعةً (collection) تضم جميع المجموعات (groups) المتطابقة باستعمال تعبير نمطي محدد.

range

تمثل هذه الخاصية مجال الفهارس الذي يحدد مكان مُطابقة تعبير نمطي محدد في السلسلة النصية الأصلية.

value

تمثل هذه الخاصية السلسلة النصية المُدخلة، أو جزءًا منها، والمُطابقة للتعبير النمطي.

الدوال

next

تعيد هذه الدالة كائنًا من النوع MatchResult يحوي ناتج المطابقة التالية لتعبير نمطي محدد والذي يبدأ عند الفهرس الذي انتهت عنده آخر عملية مطابقة.

الدوال الموروثة (Inherited Functions)

equals

تتحقق هذه الدالة إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت عبره. 

hashCode

تعيد هذه الدالة الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها.

toString

تحول هذه الدالة الكائن الذي يُستدعى معه إلى سلسلة نصية (String).

مصادر