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

مراجعة 13:53، 8 يوليو 2018

تعيد الدالة count()‎ عدد حروف السلسلة النصية التي استُدعيت عبرها، وفي حال تمرير دالة منطقية predicate فستعيد عدد الحروف التي تحقق تلك الدالة المنطقية.

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

inline fun CharSequence.count(): Int 

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

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

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

عدد من النوع Int.

أمثلة

استخدام الدالة `()count` مع سلسلة نصية

تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تستدعي الدالة ()count عبرها، ثمَّ تطبع الناتج:

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

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

استخدام الدالة ()count مع سلسلة نصية مع تمرير دالة منطقية كوسيط تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تستدعي الدالة ()count عبرها مع تمرير دالة منطقية كوسيط، ثمَّ تطبع الناتج:

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

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

انظر أيضًا

contains()‎: تعيد القيمة true إن كانت سلسلة الحروف التي استُدعيت عبرها تحتوي الحرف أو سلسلة الحروف المُمرّرة. الوسيطignoreCase يحدد ما إذا كانت الدالة ستتجاهل حالة الحروف.

compareTo()‎: تقارن بين سلسلتين نصيتين.
asSequence()‎: تنشئ كائنًا من الصنف Sequence والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>text.count()‎</code> في لغة Kotlin}}</noinclude>
-تعيد الدالة <code>count()‎</code> القيمة <code>true</code> إن كانت [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها تساوي [[Kotlin/CharSequence/index|سلسلة الحروف]] أو الكائن (<code>StringBuffer</code>) المُمرّر.
+تعيد الدالة <code>count()‎</code> عدد حروف [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها، وفي حال تمرير دالة منطقية <code>predicate</code> فستعيد عدد الحروف التي تحقق تلك الدالة المنطقية.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-inline fun String.contentEquals(
+inline fun CharSequence.count(): Int
-    charSequence: CharSequence
-): Boolean
-inline fun String.contentEquals(
+inline fun CharSequence.count(
-     stringBuilder: StringBuffer
+     predicate: (Char) -> Boolean
-): Boolean
+): Int
-</syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM'''
-يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 ==القيم المعادة==
-قيمة منطقية.
+عدد من النوع <code>Int</code>.
 ==أمثلة==
 ===استخدام الدالة <code>()count</code> مع سلسلة نصية===
-تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()count</code> عبرها مع تمرير  [[Kotlin/String|سلسلة نصية]] كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
+تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()count</code> عبرها، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
      val str = "hsoub"
-     println(str.contentEquals("hsoub")) // => true
+     println(str.count()) // => 5
-    println(str.contentEquals("abc")) // => false
+}
+</syntaxhighlight>استخدام الدالة <code>()count</code> مع سلسلة نصية مع تمرير دالة منطقية كوسيط
+تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()count</code> عبرها مع تمرير  دالة منطقية كوسيط، ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
+fun main(args: Array<String>) {
+    val str = "Hsoub Wiki"
+    println(str.count {it.isUpperCase()}) // => 2
 }
 </syntaxhighlight>
@@ سطر 34: / سطر 38: @@
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/content-equals.html الدالة text.count()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/count.html الدالة text.count()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]