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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط
 
(4 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع text.toLowerCase()‎ في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE:الدالة <code>toLowerCase()‎</code> في Kotlin}}</noinclude>
تحوّل الدالة <code>toLowerCase()</code>‎ [[Kotlin/Char/index|الحرف]] أو [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها إلى حالة الأحرف الصغيرة (lowercase).
+
تحوّل الدالة <code>toLowerCase()</code>‎ [[Kotlin/Char|المحرف]] أو جميع محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها إلى محارف صغيرة (lowercase).
 
+
==البنية العامة==
== البنية العامة ==
 
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
 
inline actual fun Char.toLowerCase(): Char
 
inline actual fun Char.toLowerCase(): Char
 
</syntaxhighlight>يمكن استدعاء الدالة <code>toLowerCase()</code>‎ عبر [[Kotlin/Char/index|حرف]].<syntaxhighlight lang="kotlin">
 
 
inline actual fun String.toLowerCase(): String
 
inline actual fun String.toLowerCase(): String
 +
inline fun String.toLowerCase(locale: Locale): String
 +
</syntaxhighlight>'''المنصة المطلوبة''': JVM.
  
</syntaxhighlight>يمكن استدعاء الدالة <code>toLowerCase()</code>‎ عبر [[Kotlin/String|سلسلة نصية]].<syntaxhighlight lang="kotlin">
+
وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
inline fun String.toLowerCase(locale: Locale): String
 
 
 
</syntaxhighlight>
 
  
يمكن استدعاء الدالة <code>toLowerCase()</code>‎ عبر [[Kotlin/String|سلسلة نصية]]، مع تمرير وسيط من نوع <code>locale</code>والذي يمرّر  الخصائص الثقافية واللغوية للمنطقة الجغرافية المحلية.
+
== المعاملات ==
  
يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+
=== <code>locale</code> ===
 +
المحلية المراد ضبطها إلى منطقة جغرافية محددة وأخذها بالحسبان أثناء عملية التحويل.
  
== القيم المعادة ==
+
==القيم المعادة==
[[Kotlin/String|سلسلة نصية]] أو [[Kotlin/Char/index|حرف]].
+
يعاد [[Kotlin/Char|المحرف]] المعطى بعد تحويله إلى محرف صغير، أو تعاد [[Kotlin/String|السلسلة النصية]] المعطاة بعد تحويل جميع محارفها إلى محارف صغيرة.
 +
==أمثلة==
 +
مثالٌ على استعمال الدالة <code>toLowerCase()‎</code>:<syntaxhighlight lang="kotlin">
 +
fun main(args: Array<String>) {
 +
    val x = "HSOUB"
  
== أمثلة ==
 
 
=== استخدام الدالة <code>toLowerCase()‎</code> مع سلسلة نصية ===
 
تُعرّف الشيفرة الآتية <nowiki/>[[Kotlin/String|سلسلة نصية]] باسم <code>x</code> ثم تستدعي الدالة <code>toLowerCase()‎</code> عبر <code>x</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 
fun main(args: Array<String>) {   
 
    val x = "HSOUB"
 
   
 
 
     print(x.toLowerCase()) // hsoub
 
     print(x.toLowerCase()) // hsoub
 
}
 
}
 
+
</syntaxhighlight>مثالٌ آخر على استعمال الدالة <code>toLowerCase()‎</code> لتحويل الحرف <code>I</code> إلى حرف صغير مع تمرير المعامل <code>Locale("tr")‎</code> الذي يضبط المحلية إلى اللغة التركية:<syntaxhighlight lang="kotlin">
</syntaxhighlight>
 
=== استخدام الدالة <code>toLowerCase()‎</code> مع حرف مع تمرير وسيط ===
 
تستدعي الشيفرة الآتية  الدالة <code>toLowerCase()‎</code> عبر [[Kotlin/Char/index|الحرف]] <code>I</code>،  مع تمرير المتغير <code>Locale("tr")‎</code> الذي يحدد الخصوصيات المحلية للغة التركية، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 
 
import java.util.Locale
 
import java.util.Locale
  
 
fun main(args: Array<String>) {   
 
fun main(args: Array<String>) {   
 
 
 
     println("I".toLowerCase(Locale("tr"))) // ı
 
     println("I".toLowerCase(Locale("tr"))) // ı
 
}
 
}
 
 
</syntaxhighlight>
 
</syntaxhighlight>
== انظر أيضًا ==
+
==انظر أيضًا==
* <code>[[Kotlin/Byte/compareTo|compareTo()]]</code>‎ : يقارن بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة <code>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة .
+
* الدالة <nowiki/>[[Kotlin/kotlin.text/toHashSet|<code>toHashSet()</code>‎]]: تحلّل كائنًا من النوع <code>HashSet</code> يحوي كل محارف <nowiki/>[[Kotlin/CharSequence/index|السلسلة]] التي استٌدعيت معها.
 
+
* الدالة <nowiki/>[[Kotlin/kotlin.text/toInt|<code>toInt()</code>‎]]: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح.
* <code>[[Kotlin/Byte/dec|dec()]]</code>‎ : تخفض قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
+
* الدالة [[Kotlin/kotlin.text/toMutableList|<code>toMutableList()</code>‎]]: تضيف كل محارف [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها إلى [[Kotlin/collections/List|قائمة متغيرة]]، إذ يوضع كل محرف في عنصر.
* <code>[[Kotlin/Byte/inc|inc()]]</code>‎ : ترفع قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
+
* الدالة [[Kotlin/kotlin.text/toRegex|<code>toRegex()</code>‎]]: تحول [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها إلى [[Kotlin/kotlin.text/Regex/index|تعبير نمطي]] (regular expression). 
* <code>[[Kotlin/text/isDefined|isDefined()]]</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
+
* الدالة [[Kotlin/kotlin.text/toSet|<code>toSet()</code>‎]]: تضيف كل محارف [[Kotlin/CharSequence/index|سلسلة الحروف]]  التي استٌدعيت معها إلى مجموعة من النوع <code>[[Kotlin/Set|Set]]</code>، إذ يوضع كل محرف في عنصر.
 +
* الدالة [[Kotlin/kotlin.text/toSortedSet|<code>toSortedSet()</code>‎]]: تضيف كل محارف [[Kotlin/CharSequence|السلسلة]]  التي استٌدعيت معها إلى مجموعة من النوع <code>[[Kotlin/collections/SortedSet|SortedSet]]</code>، إذ يوضع كل محرف في عنصر.
 +
* الدالة [[Kotlin/kotlin.text/toString|<code>toString()</code>‎]] : تحول العدد الذي استٌدعي معها وفقًا لأساس مُحدّد إلى [[Kotlin/String|سلسلة نصية]].
 +
* الدالة [[Kotlin/text/toTitleCase|<code>toTitleCase()</code>‎]]: تحول [[Kotlin/Char|المحرف]] الذي استٌدعي معها إلى محرف عنواني (titlecase). تتكون المحارف العنوانية عادةً من محرفين ملتصقين، مثل <code>'Dž'</code> أو <code>'Nj'</code>، إذ يعاملان وكأنَّهما محرفٌ واحدٌ فقط.
 +
* الدالة [[Kotlin/text/toUpperCase|<code>toUpperCase()</code>‎]]: تحول [[Kotlin/Char|المحرف]] أو جميع محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها إلى محارف كبيرة (uppercase).
  
== مصادر ==
+
==مصادر==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-lower-case.html صفحة الدالة toLowerCase()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-lower-case.html صفحة الدالة toLowerCase()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Method]]
+
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin Text]]

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

تحوّل الدالة toLowerCase()المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف صغيرة (lowercase).

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

inline actual fun Char.toLowerCase(): Char
inline actual fun String.toLowerCase(): String
inline fun String.toLowerCase(locale: Locale): String

المنصة المطلوبة: JVM.

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

المعاملات

locale

المحلية المراد ضبطها إلى منطقة جغرافية محددة وأخذها بالحسبان أثناء عملية التحويل.

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

يعاد المحرف المعطى بعد تحويله إلى محرف صغير، أو تعاد السلسلة النصية المعطاة بعد تحويل جميع محارفها إلى محارف صغيرة.

أمثلة

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

fun main(args: Array<String>) {
    val x = "HSOUB"

    print(x.toLowerCase()) // hsoub
}

مثالٌ آخر على استعمال الدالة toLowerCase()‎ لتحويل الحرف I إلى حرف صغير مع تمرير المعامل Locale("tr")‎ الذي يضبط المحلية إلى اللغة التركية:

import java.util.Locale

fun main(args: Array<String>) {  
    println("I".toLowerCase(Locale("tr"))) // ı
}

انظر أيضًا

مصادر