الفرق بين المراجعتين ل"Kotlin/kotlin.text/intern"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة text.intern()‎ في لغة Kotlin}}</noinclude> تعيد الدالة <code>intern()‎</code> فهرس أول ظهور للح...')
 
(مراجعة وتدقيق.)
 
(3 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة text.intern()‎ في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: الدالة String.intern()‎ في Kotlin}}</noinclude>
تعيد الدالة <code>intern()‎</code> فهرس أول ظهور للحرف أو [[Kotlin/String|السلسلة النصية]] المُمرّرة إليها في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها بداية من الفهرس المُمرّر <code>startIndex</code>، في حال كان ذلك الحرف غير موجود فستعيد العدد ‎<code>-1</code>.  
+
تعيد الدالة <code>intern()‎</code> تمثيلًا معياريًّا (canonical representation) [[Kotlin/String|للسلسلة النصية]] التي استُدعيت معها.
 +
== البنية العامة ==
 +
<syntaxhighlight lang="kotlin">
 +
inline fun String.intern(): String
  
في حال إعطاء الوسيط <code>ignoreCase</code>  القيمة <code>true</code> فإنّ الدالة <code>indexOf()‎</code> لن تفرق بين الحروف الكبيرة والصغيرة.
+
</syntaxhighlight>'''بيئة التشغيل المطلوبة''': JVM.
== البنية العامة ==
 
يمكن استدعاء  الدالة <code>indexOf()‎</code> عبر [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin">
 
fun CharSequence.indexOf(
 
    char: Char,
 
    startIndex: Int = 0,
 
    ignoreCase: Boolean = false
 
): Int
 
  
fun CharSequence.indexOf(
 
    string: String,
 
    startIndex: Int = 0,
 
    ignoreCase: Boolean = false
 
): Int
 
</syntaxhighlight>
 
 
== القيم المعادة ==
 
== القيم المعادة ==
فهرس أول ظهور للعنصر المُمرّر أو  العدد ‎<code>-1</code>.
+
تعاد [[Kotlin/String|سلسلة نصية]].
 
== أمثلة ==
 
== أمثلة ==
 
+
<nowiki/><nowiki/>مثالٌ على استعمال الدالة <code>()intern</code>:<syntaxhighlight lang="kotlin">
=== استخدام  الدالة<code>()intern</code>مع سلسلة نصية مع تمرير حرف كوسيط  ===
 
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/String|سلسلة نصية]] باسم <code>str</code><nowiki/>، ثم تستخدم الدالة  <code>()intern</code>  للحصول على فهرس أول ظهور للحرفين <code>'x'</code> و<code>'s'</code> ، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
var str = "hsoub"
+
    var str = "hsoub"
   
 
print(str.indexOf('s')) // 1
 
print(str.indexOf('x')) // -1
 
  
 +
    print(str.intern()) // hsoub
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
  
=== استخدام  الدالة<code>()indexOf</code>مع سلسلة نصية مع تمرير سلسلة نصية كوسيط  ===
+
== <nowiki/>انظر أيضًا ==
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثم تستخدم الدالة  <code>()indexOf</code>  للحصول على فهرس أول ظهور  [[Kotlin/String|للسلسلتين النصيتين]]<code>"sou"</code> و<code>"sx"</code> ، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+
* الدالة <code>[[Kotlin/kotlin.text/format|format()‎]]</code>: تنسِّق سلسلة نصية وفقًا لقيمة المعاملات التي تمرر إليها.
fun main(args: Array<String>) {
 
var str = "hsoub"
 
   
 
print(str.indexOf("sou")) // 1
 
print(str.indexOf("sx")) // -1
 
}
 
</syntaxhighlight>
 
== انظر أيضًا ==
 
* <code>[[Kotlin/kotlin.text/indexOfAny|indexOfAny]]()‎</code>: تعيد  فهرس أول ظهور للحرف أو [[Kotlin/String|السلسلة النصية]] المُمرّرة إليها في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها بداية من الفهرس المُمرّر <code>startIndex</code>، في حال كان ذلك الحرف أو تلك  [[Kotlin/String|السلسلة النصية]] المُمرّرة غير موجودة فستعيد الدالةُ العدد ‎<code>-1</code>.
 
  
 
== مصادر ==
 
== مصادر ==
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/index-of.html الدالة text.intern()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
+
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/intern.html صفحة الدالة String.intern()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Methods]]
+
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin Text]]
 +
[[تصنيف:Kotlin String]]

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

تعيد الدالة intern()‎ تمثيلًا معياريًّا (canonical representation) للسلسلة النصية التي استُدعيت معها.

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

inline fun String.intern(): String

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

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

تعاد سلسلة نصية.

أمثلة

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

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

    print(str.intern()) // hsoub
}

انظر أيضًا

  • الدالة format()‎: تنسِّق سلسلة نصية وفقًا لقيمة المعاملات التي تمرر إليها.

مصادر