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

المراجعة الحالية بتاريخ 13:02، 2 سبتمبر 2018

تَعُدُّ الدالة count()‎ جميع محارف سلسلة المحارف التي استُدعيت معها، أو المحارف المحققة لشرط معين.

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

inline fun CharSequence.count(): Int 

inline fun CharSequence.count(
    predicate: (Char) -> Boolean
): Int

وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)).

المعاملات

`predicte`

دالةٌ تمثل شرط معين يطبق على كل محرف من محارف السلسلة النصية المعطاة، وتعيد مع كل واحد منها قيمة منطقية.

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

يعاد عدد صحيح يمثل عدد محارف السلسلة المعطاة جميعها، أو عدد المحارف المحققة للشرط المحدد في المعامل predicte إن أعطي.

أمثلة

مثالٌ على استعمال الدالة ()count لعد جميع محارف سلسلة نصية:

fun main(args: Array<String>) {
    val str = "hsoub"

    println(str.count()) // => 5
}

مثالٌ على استعمال الدالة ()count لعد المحارف الكبيرة فقط الموجودة في سلسلة نصية:

fun main(args: Array<String>) {
    val str = "Hsoub Wiki"

    println(str.count {it.isUpperCase()}) // => 2
}

انظر أيضًا

الدالة contentEquals()‎: تتحقق من تساوي محتوى السلسلة النصية التي استُدعيت معها مع محتوى سلسلة المحارف أو الكائن StringBuffer المُمرّر إليها.
الدالة compareTo()‎: توازن بين سلسلتين نصيتين معجميًّا (lexicographically)، مع إمكانية تجاهل حالة الأحرف.
الدالة chunked()‎: تقطِّع سلسلة المحارف التي استُدعيت معها إلى عدة أجزاء لا يتجاوز كل منها حجمًا معينًا وتعيدها في قائمة أو تطبِّق دالة معينة على كل منها وتضع الناتج الذي تعيده هذه الدالة في قائمة.

مصادر

صفحة الدالة CharSequence.count()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>text.count()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.count()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>count()‎</code> عدد حروف [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها، وفي حال تمرير دالة منطقية <code>predicate</code> فستعيد عدد الحروف التي تحقق تلك الدالة المنطقية.
+تَعُدُّ الدالة <code>count()‎</code> جميع محارف [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها، أو المحارف المحققة لشرط معين.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
@@ سطر 10: / سطر 10: @@
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
+== المعاملات ==
+=== <code>predicte</code> ===
+دالةٌ تمثل شرط معين يطبق على كل محرف من محارف السلسلة النصية المعطاة، وتعيد مع كل واحد منها قيمة منطقية.
 ==القيم المعادة==
-عدد من النوع <code>Int</code>.
+يعاد عدد صحيح يمثل عدد محارف [[Kotlin/CharSequence|السلسلة]] المعطاة جميعها، أو عدد المحارف المحققة للشرط المحدد في المعامل <code>predicte</code> إن أعطي.
 ==أمثلة==
-===استخدام الدالة <code>()count</code> مع سلسلة نصية===
+مثالٌ على استعمال الدالة <code>()count</code> لعد جميع محارف سلسلة نصية<nowiki/>:<syntaxhighlight lang="kotlin">
-تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()count</code> عبرها، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
      val str = "hsoub"
@@ سطر 22: / سطر 26: @@
      println(str.count()) // => 5
 }
-</syntaxhighlight>
+</syntaxhighlight>مثالٌ على استعمال الدالة <code>()count</code> لعد المحارف الكبيرة فقط الموجودة في سلسلة نصية:<syntaxhighlight lang="kotlin">
-=== استخدام الدالة <code>()count</code> مع سلسلة نصية مع تمرير دالة منطقية كوسيط ===
-تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()count</code> عبرها مع تمرير  دالة منطقية كوسيط، ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
      val str = "Hsoub Wiki"
@@ سطر 34: / سطر 35: @@
 == انظر أيضًا ==
-* <code>[[Kotlin/kotlin.text/contains|contains()]]‎</code>: تعيد القيمة <code>true</code> إن كانت سلسلة الحروف التي استُدعيت عبرها تحتوي الحرف أو سلسلة الحروف المُمرّرة. الوسيط<code>ignoreCase</code> يحدد ما إذا كانت الدالة ستتجاهل حالة الحروف.
+* الدالة <code>[[Kotlin/kotlin.text/contentEquals|contentEquals()‎]]</code>: تتحقق من تساوي محتوى [[Kotlin/String|السلسلة النصية]] التي استُدعيت معها مع محتوى [[Kotlin/CharSequence|سلسلة المحارف]] أو الكائن <code>[[Kotlin/kotlin.text/StringBuffer|StringBuffer]]</code> المُمرّر إليها.
+* الدالة <code>[[Kotlin/kotlin.text/compareTo|compareTo()]]‎</code>: توازن بين [[Kotlin/String|سلسلتين نصيتين]] معجميًّا (lexicographically)، مع إمكانية تجاهل حالة الأحرف.
-* <code>[[Kotlin/kotlin.text/compareTo|compareTo()]]‎</code>: تقارن بين سلسلتين نصيتين.
+* الدالة <code>[[Kotlin/kotlin.text/chunked|chunked()‎]]</code>: تقطِّع <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها إلى عدة أجزاء لا يتجاوز كل منها حجمًا معينًا وتعيدها في قائمة أو تطبِّق دالة معينة على كل منها وتضع الناتج الذي تعيده هذه الدالة في قائمة.
-* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/count.html الدالة text.count()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/count.html صفحة الدالة CharSequence.count()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]