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

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

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

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

inline fun String.codePointBefore(index: Int): Int

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

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

المعاملات

`index`

عدد صحيح يمثل فهرس العنصر الذي يلي العنصر المستهدف في السلسلة النصية المعطاة.

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

يعاد عدد صحيح يمثل المحرف الذي يسبق المحرف ذا الفهرس index من السلسلة النصية المعطاة.

أمثلة

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

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

    println(str.codePointBefore(1)) // => 104 
    println(str.codePointBefore(2)) // => 115 
}

انظر أيضًا

الدالة codePointAt()‎: تعيد المحرف (Unicode code point) عند الفهرس المُحدّد.
الدالة codePointCount()‎: تعيد عدد محارف الترميز الموحد (Unicode code point) الموجودة في مجال مُحدّد من سلسلة نصية.
الدالة offsetByCodePoints()‎: تعيد فهرس المحرف الموجود في السلسلة النصية التي استٌدعيت معها والذي ينزاح بمقدار محدد بدءًا من عنصر ذي فهرس محدد.

مصادر

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

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