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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(مراجعة وتدقيق.)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع text.toLowerCase()‎ في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE:الدالة <code></code>text.toLowerCase()‎ في 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
  
</syntaxhighlight>يمكن استدعاء الدالة <code>toLowerCase()</code>‎ عبر [[Kotlin/String|سلسلة نصية]].<syntaxhighlight lang="kotlin">
+
</syntaxhighlight>يمكن استدعاء الدالة <code>toLowerCase()</code>‎ مع [[Kotlin/Char|حرف]]، ومع [[Kotlin/String|سلسلة نصية]].<syntaxhighlight lang="kotlin">
inline fun String.toLowerCase(locale: Locale): String  
+
inline fun String.toLowerCase(locale: Locale): String
 
+
</syntaxhighlight>المنصة المطلوبة: '''JVM'''.
</syntaxhighlight>
 
 
 
يمكن استدعاء الدالة <code>toLowerCase()</code>‎ عبر [[Kotlin/String|سلسلة نصية]]، مع تمرير وسيط من نوع <code>locale</code>والذي يمرّر  الخصائص الثقافية واللغوية للمنطقة الجغرافية المحلية.
 
  
يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+
يمكن أيضًا استدعاء الدالة مع [[Kotlin/String|سلسلة نصية]] ومع تمرير الوسيط <code>locale</code> الذي يضبط المحلية إلى المنطقة الجغرافية الحالية المطلوبة.
  
== القيم المعادة ==
+
وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
[[Kotlin/String|سلسلة نصية]] أو [[Kotlin/Char/index|حرف]].
+
==القيم المعادة==
 
+
يعاد الحرف <code>Char</code> المعطى بعد تحويله إلى حروف صغير، أو السلسلة النصية <code>String</code> المعطاة بعد تحويل جميع حروفها إلى حروفٍ صغيرة.
== أمثلة ==
+
==أمثلة==
 
+
استعمال الدالة <code>toLowerCase()‎</code> لتحويل حروف سلسلة نصية إلى حروف صغيرة:<syntaxhighlight lang="kotlin">
=== استخدام الدالة <code>toLowerCase()‎</code> مع سلسلة نصية ===
 
تُعرّف الشيفرة الآتية <nowiki/>[[Kotlin/String|سلسلة نصية]] باسم <code>x</code> ثم تستدعي الدالة <code>toLowerCase()‎</code> عبر <code>x</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 
 
fun main(args: Array<String>) {     
 
fun main(args: Array<String>) {     
 
     val x = "HSOUB"
 
     val x = "HSOUB"
سطر 31: سطر 23:
 
}
 
}
  
</syntaxhighlight>
+
</syntaxhighlight>استعمال الدالة <code>toLowerCase()‎</code> لتحويل الحرف <code>I</code> إلى حرف صغير مع تمرير الوسيط <code>Locale("tr")‎</code> الذي يضبط المحلية إلى اللغة التركية:<syntaxhighlight lang="kotlin">
=== استخدام الدالة <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/text/toUpperCase|toUpperCase()]]</code>‎ : تحوّل الدالة <code>toUpperCase()</code>‎ الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).
+
*الدالة <code>[[Kotlin/text/toTitleCase|toTitleCase()]]</code>‎ : تحوّل <nowiki/>[[Kotlin/Char|المحرف]] الذي استٌدعي معها إلى محرف عنواني (titlecase).
 
+
*الدالة <code>[[Kotlin/text/toUpperCase|toUpperCase()]]</code>‎ : تحوّل [[Kotlin/Char|الحرف]] أو جميع حروف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها إلى حروف كبيرة (uppercase).
*<code>[[Kotlin/text/isDefined|isDefined()]]</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
+
* الدالة <nowiki/>[[Kotlin/text/isLetter|<code>isLetter()</code>‎]]: تتحقق إن كان المحرف (character) الذي استٌدعي معها حرفًا أبجديًا.
 
+
* الدالة <nowiki/>[[Kotlin/text/isLowerCase|<code>isLowerCase()</code>‎]]: تتحقق إن كان الحرف الذي استٌدعي معها حرفًا صغيرًا (lower case).
* <code>[[Kotlin/text/isDefined|isDefined()]]</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
+
* الدالة <nowiki/>[[Kotlin/text/plus|<code>plus()</code>‎]]: تضيف الحرف الذي استٌدعي معها إلى بداية السلسلة النصية المُمرّرة إليها.
 
+
==مصادر==
== مصادر ==
+
*[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 Method]]

مراجعة 15:29، 13 أغسطس 2018

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

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

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

يمكن استدعاء الدالة toLowerCase()‎ مع حرف، ومع سلسلة نصية.

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

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

يمكن أيضًا استدعاء الدالة مع سلسلة نصية ومع تمرير الوسيط locale الذي يضبط المحلية إلى المنطقة الجغرافية الحالية المطلوبة.

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

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

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

أمثلة

استعمال الدالة 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"))) // ı
}

انظر أيضًا

  • الدالة toTitleCase()‎ : تحوّل المحرف الذي استٌدعي معها إلى محرف عنواني (titlecase).
  • الدالة toUpperCase()‎ : تحوّل الحرف أو جميع حروف السلسلة النصية التي استٌدعيت معها إلى حروف كبيرة (uppercase).
  • الدالة isLetter(): تتحقق إن كان المحرف (character) الذي استٌدعي معها حرفًا أبجديًا.
  • الدالة isLowerCase(): تتحقق إن كان الحرف الذي استٌدعي معها حرفًا صغيرًا (lower case).
  • الدالة plus(): تضيف الحرف الذي استٌدعي معها إلى بداية السلسلة النصية المُمرّرة إليها.

مصادر