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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط
(مراجعة وتدقيق.)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:الدالة <code>text.toLowerCase()‎</code> في Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE:الدالة <code>toLowerCase()‎</code> في Kotlin}}</noinclude>
تحوّل الدالة <code>toLowerCase()</code>‎ [[Kotlin/Char|الحرف]] أو جميع حروف [[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
 
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/Char|حرف]]، ومع [[Kotlin/String|سلسلة نصية]].<syntaxhighlight lang="kotlin">
+
وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
inline fun String.toLowerCase(locale: Locale): String
+
 
</syntaxhighlight>المنصة المطلوبة: '''JVM'''.
+
== المعاملات ==
  
يمكن أيضًا استدعاء الدالة مع [[Kotlin/String|سلسلة نصية]] ومع تمرير الوسيط <code>locale</code> الذي يضبط المحلية إلى المنطقة الجغرافية الحالية المطلوبة.
+
=== <code>locale</code> ===
 +
المحلية المراد ضبطها إلى منطقة جغرافية محددة وأخذها بالحسبان أثناء عملية التحويل.
  
وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
 
 
==القيم المعادة==
 
==القيم المعادة==
يعاد الحرف <code>Char</code> المعطى بعد تحويله إلى حروف صغير، أو السلسلة النصية <code>String</code> المعطاة بعد تحويل جميع حروفها إلى حروفٍ صغيرة.
+
يعاد [[Kotlin/Char|المحرف]] المعطى بعد تحويله إلى محرف صغير، أو تعاد [[Kotlin/String|السلسلة النصية]] المعطاة بعد تحويل جميع محارفها إلى محارف صغيرة.
 
==أمثلة==
 
==أمثلة==
استعمال الدالة <code>toLowerCase()‎</code> لتحويل حروف سلسلة نصية إلى حروف صغيرة:<syntaxhighlight lang="kotlin">
+
مثالٌ على استعمال الدالة <code>toLowerCase()‎</code>:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {  
+
fun main(args: Array<String>) {
 
     val x = "HSOUB"
 
     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>I</code> إلى حرف صغير مع تمرير الوسيط <code>Locale("tr")‎</code> الذي يضبط المحلية إلى اللغة التركية:<syntaxhighlight lang="kotlin">
 
 
import java.util.Locale
 
import java.util.Locale
  
سطر 29: سطر 30:
 
     println("I".toLowerCase(Locale("tr"))) // ı
 
     println("I".toLowerCase(Locale("tr"))) // ı
 
}
 
}
 
 
</syntaxhighlight>
 
</syntaxhighlight>
 
==انظر أيضًا==
 
==انظر أيضًا==
*الدالة <code>[[Kotlin/text/toTitleCase|toTitleCase()]]</code>‎ : تحوّل <nowiki/>[[Kotlin/Char|المحرف]] الذي استٌدعي معها إلى محرف عنواني (titlecase).
+
*الدالة <code>[[Kotlin/kotlin.text/toBigDecimalOrNull|toBigDecimalOrNull()]]‎</code>: تحلّل الدالة <code>toBigDecimalOrNull()</code>‎ [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها وتحوّلها إلى عدد من النوع <code>BigDecimal</code>.
*الدالة <code>[[Kotlin/text/toUpperCase|toUpperCase()]]</code>‎ : تحوّل [[Kotlin/Char|الحرف]] أو جميع حروف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها إلى حروف كبيرة (uppercase).
+
*الدالة [[Kotlin/kotlin.text/toBigInteger|<code>toBigInteger()</code>‎]]: تحلّل [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها وتحوّلها إلى عدد من النوع <code>BigDecimal</code>.
* الدالة <nowiki/>[[Kotlin/text/isLetter|<code>isLetter()</code>‎]]: تتحقق إن كان المحرف (character) الذي استٌدعي معها حرفًا أبجديًا.
+
*الدالة [[Kotlin/kotlin.text/toBigIntegerOrNull|<code>toBigIntegerOrNull()</code>‎]]: تحلّل [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها وتحوّلها إلى عدد من النوع <code>BigInteger</code>.
* الدالة <nowiki/>[[Kotlin/text/isLowerCase|<code>isLowerCase()</code>‎]]: تتحقق إن كان الحرف الذي استٌدعي معها حرفًا صغيرًا (lower case).
+
*الدالة [[Kotlin/kotlin.text/toBoolean|<code>toBoolean()</code>‎]]: تعيد القيمة <code>true</code> إن كانت [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها تساوي <code>"true"</code> مع تجاهل حالة الأحرف، أو تعيد القيمة <code>false</code>.
* الدالة <nowiki/>[[Kotlin/text/plus|<code>plus()</code>‎]]: تضيف الحرف الذي استٌدعي معها إلى بداية السلسلة النصية المُمرّرة إليها.
+
*الدالة [[Kotlin/kotlin.text/toByte|<code>toByte()</code>‎]]: تحلّل [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها وتحوّلها إلى عدد من النوع <code>[[Kotlin/Byte|Byte]]</code>.
 +
*الدالة [[Kotlin/kotlin.text/toByteArray|<code>toByteArray()</code>‎]]: ترمز جميع محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها وفقًا لترميز محدد ثم تضع الناتج في مصفوفة من النوع <code>[[Kotlin/ByteArray|ByteArray]]</code>.
 +
*الدالة <code>[[Kotlin/text/toUpperCase|toUpperCase()]]</code>‎ : تحوّل المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف كبيرة (uppercase).
 +
*الدالة [[Kotlin/kotlin.text/toCharArray|<code>toCharArray()</code>‎]]: تضع جميع محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها في مصفوفة من النوع <code>[[Kotlin/CharArray|CharArray]]</code>، إذ يوضع كل محرف في عنصر.
 +
*الدالة <nowiki/>[[Kotlin/kotlin.text/toCollection|<code>toCollection()</code>‎]]: تضيف كل محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استٌدعيت معها إلى المجموعة المتغيرة المُمرّرة إليها.
 +
*الدالة <nowiki/>[[Kotlin/kotlin.text/toDouble|<code>toDouble()</code>‎]]: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى <nowiki/>[[Kotlin/Double|عدد عشري مضاعف]].
 +
*الدالة <nowiki/>[[Kotlin/kotlin.text/toDoubleOrNull|<code>toDoubleOrNull()</code>‎]]: تحلّل السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى <nowiki/>[[Kotlin/Double|عدد عشري مضاعف]].
 +
 
 +
* الدالة <nowiki/>[[Kotlin/kotlin.text/toFloat|<code>toFloat()</code>‎]]: تحلّل السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى <nowiki/>[[Kotlin/Float|عدد عشري]].
 +
* الدالة <nowiki/>[[Kotlin/kotlin.text/toFloatOrNull|<code>toFloatOrNull()</code>‎]]: تحلّل السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى <nowiki/>[[Kotlin/Float|عدد عشري]].
 +
* الدالة <nowiki/>[[Kotlin/kotlin.text/toHashSet|<code>toHashSet()</code>‎]]: تحلّل كائنًا من النوع <code>HashSet</code> يحوي كل محارف <nowiki/>[[Kotlin/CharSequence/index|السلسلة]] التي استٌدعيت معها.
 +
* الدالة <nowiki/>[[Kotlin/kotlin.text/toInt|<code>toInt()</code>‎]]: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح.
 +
* الدالة <nowiki/>[[Kotlin/kotlin.text/toIntOrNull|<code>toIntOrNull()</code>‎]]: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح.
 +
* الدالة [[Kotlin/kotlin.text/toList|<code>toList()</code>‎]]: تضيف كل محارف [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها إلى [[Kotlin/collections/List|قائمة]]، إذ يوضع كل محرف في عنصر.
 +
* الدالة <code>[[Kotlin/kotlin.text/toLong|toLong()]]</code>‎: تحلّل [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها وتحوّلها إلى [[Kotlin/Long|عدد طويل]].
 +
* الدالة [[Kotlin/kotlin.text/toLongOrNull|<code>toLongOrNull()</code>‎]]: تحلّل [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى [[Kotlin/Long|عدد طويل]].
 +
* الدالة [[Kotlin/text/toLowerCase|<code>toLowerCase()</code>‎]]: تحول [[Kotlin/Char|المحرف]] أو جميع محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها إلى محارف صغيرة (lowercase).
 +
* الدالة [[Kotlin/kotlin.text/toMutableList|<code>toMutableList()</code>‎]]: تضيف كل محارف [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها إلى [[Kotlin/collections/List|قائمة متغيرة]]، إذ يوضع كل محرف في عنصر.
 +
* الدالة [[Kotlin/kotlin.text/toPattern|<code>toPattern()</code>‎]]: تحول [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها إلى نمط.
 +
* الدالة [[Kotlin/kotlin.text/toRegex|<code>toRegex()</code>‎]]: تحول [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها إلى [[Kotlin/kotlin.text/Regex/index|تعبير نمطي]] (regular expression). 
 +
* الدالة [[Kotlin/kotlin.text/toSet|<code>toSet()</code>‎]]: تضيف كل محارف [[Kotlin/CharSequence/index|سلسلة الحروف]]  التي استٌدعيت معها إلى مجموعة من النوع <code>[[Kotlin/Set|Set]]</code>، إذ يوضع كل محرف في عنصر.
 +
* الدالة [[Kotlin/kotlin.text/toShort|<code>toShort()</code>‎]]: تحلّل [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها وتحوّلها إلى [[Kotlin/Short|عدد قصير.]]
 +
* الدالة [[Kotlin/kotlin.text/toShortOrNull|<code>toShortOrNull()</code>‎]]: تحلّل [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها وتحوّلها إلى [[Kotlin/Short|عدد قصير]].
 +
* الدالة [[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]]

مراجعة 09:07، 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"))) // ı
}

انظر أيضًا

مصادر