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

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

تعيد الدالة codePointCount()‎ عدد محارف الترميز الموحد (Unicode code point) الموجودة في مجال مُحدّد من سلسلة نصية.

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

inline fun String.codePointCount(
    beginIndex: Int, 
    endIndex: Int
): Int

منصة التشغيل المطلوبة: JVM.

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

المعاملات

`beginIndex`

عدد صحيح يشير إلى فهرس العنصر الذي يمثل بداية المجال في السلسلة النصية المعطاة.

endIndex

عدد صحيح يشير إلى فهرس العنصر (لا يدخل ضمن المجال) الذي يمثل نهاية المجال في السلسلة النصية المعطاة.

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

يعاد عدد صحيح يمثل عدد محارف الترميز الموحد (Unicode code point) الموجودة في المجال الذي يبدأ عند العنصر ذي الفهرس beginIndex وينتهي عند العنصر ذي الفهرس endIndex ضمن السلسلة النصية المعطاة.

أمثلة

مثالٌ على استخدام الدالة ()codePointCount:

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

    println(str.codePointCount(2, 8)) // => 6
}

انظر أيضًا

الدالة codePointAt()‎: تعيد المحرف (Unicode code point) عند الفهرس المُحدّد.

الدالة codePointBefore()‎: تعيد المحرف (Unicode code point) الموجود قبل الفهرس المُحدّد.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>text.codePointCount()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>String.codePointCount()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>codePointCount()‎</code> كود اليونيكود (Unicode code point) للحرف الموجود قبل الفهرس المُحدّد.
+تعيد الدالة <code>codePointCount()‎</code> عدد محارف الترميز الموحد (Unicode code point) الموجودة في مجال مُحدّد من سلسلة نصية.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-inline fun String.codePointBefore(index: Int): Int
+inline fun String.codePointCount(
+    beginIndex: Int,
+    endIndex: Int
+): Int
+</syntaxhighlight>'''منصة التشغيل المطلوبة''': JVM.
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+وجود الكلمة المفتاحية <code>inline</code> يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
+== المعاملات ==
+=== <code>beginIndex</code> ===
+عدد صحيح يشير إلى فهرس العنصر الذي يمثل بداية المجال في السلسلة النصية المعطاة.
+<code>endIndex</code>
+عدد صحيح يشير إلى فهرس العنصر (لا يدخل ضمن المجال) الذي يمثل نهاية المجال في السلسلة النصية المعطاة.
 ==القيم المعادة==
-عدد من النوع <code>Int</code>.
+يعاد عدد صحيح يمثل عدد محارف الترميز الموحد (Unicode code point) الموجودة في المجال الذي يبدأ عند العنصر ذي الفهرس <code>beginIndex</code> وينتهي عند العنصر ذي الفهرس <code>endIndex</code> ضمن السلسلة النصية المعطاة.
 ==أمثلة==
-===استخدام الدالة <code>()codePointCount</code> مع سلسلة نصية===
+مثالٌ على استخدام الدالة <code>()codePointCount</code><nowiki/>:<syntaxhighlight lang="kotlin">
-تعرِّف الشيفرة الآتية سلسلة نصية باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()codePointCount</code> عبرها، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
      val str = "hsoub Academy"
-     println(str.codePointBefore(1)) // => 104
+     println(str.codePointCount(2, 8)) // => 6
-    println(str.codePointBefore(2)) // => 115
 }
 </syntaxhighlight>
-===انظر أيضًا===
+==انظر أيضًا==
-* <code>[[Kotlin/kotlin.text/codePointAt|codePointAt()]]‎</code>: تعيد كود اليونيكود (Unicode code point) للحرف الموجود في الفهرس المُحدّد.
+* الدالة <code>[[Kotlin/kotlin.text/codePointAt|codePointAt()]]‎</code>: تعيد المحرف (Unicode code point) عند الفهرس المُحدّد.
-* <code>[[Kotlin/kotlin.text/associateByTo|associateByTo()]]‎</code>: تعيد قاموسا متغيرا (mutable map) يحتوي أزواجًا من "مفتاح/قيمة"، إذ القيمة هي عناصر سلسلة الحروف التي استُدعيت عبرها، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>.
+* الدالة <code>[[Kotlin/kotlin.text/codePointBefore|codePointBefore()]]‎</code>: تعيد المحرف (Unicode code point) الموجود قبل الفهرس المُحدّد.
-* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/code-point-before.html الدالة text.codePointCount()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/code-point-count.html صفحة الدالة String.codePointCount()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin String]]