الفرق بين المراجعتين ل"Kotlin/text/toLowerCase"
< Kotlin
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) ط |
جميل-بيلوني (نقاش | مساهمات) ط |
||
(مراجعة متوسطة واحدة بواسطة نفس المستخدم غير معروضة) | |||
سطر 1: | سطر 1: | ||
− | <noinclude>{{DISPLAYTITLE:الدالة <code> | + | <noinclude>{{DISPLAYTITLE:الدالة <code>toLowerCase()</code> في Kotlin}}</noinclude> |
− | تحوّل الدالة <code>toLowerCase()</code> [[Kotlin/Char| | + | تحوّل الدالة <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. | ||
− | + | وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]). | |
− | + | ||
− | + | == المعاملات == | |
− | + | === <code>locale</code> === | |
+ | المحلية المراد ضبطها إلى منطقة جغرافية محددة وأخذها بالحسبان أثناء عملية التحويل. | ||
− | |||
==القيم المعادة== | ==القيم المعادة== | ||
− | يعاد | + | يعاد [[Kotlin/Char|المحرف]] المعطى بعد تحويله إلى محرف صغير، أو تعاد [[Kotlin/String|السلسلة النصية]] المعطاة بعد تحويل جميع محارفها إلى محارف صغيرة. |
==أمثلة== | ==أمثلة== | ||
− | استعمال الدالة <code>toLowerCase()</code> | + | مثالٌ على استعمال الدالة <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> إلى حرف صغير مع تمرير | ||
import java.util.Locale | import java.util.Locale | ||
سطر 29: | سطر 30: | ||
println("I".toLowerCase(Locale("tr"))) // ı | println("I".toLowerCase(Locale("tr"))) // ı | ||
} | } | ||
− | |||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
− | * | + | * الدالة <nowiki/>[[Kotlin/kotlin.text/toHashSet|<code>toHashSet()</code>]]: تحلّل كائنًا من النوع <code>HashSet</code> يحوي كل محارف <nowiki/>[[Kotlin/CharSequence/index|السلسلة]] التي استٌدعيت معها. |
− | * | + | * الدالة <nowiki/>[[Kotlin/kotlin.text/toInt|<code>toInt()</code>]]: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح. |
− | * | + | * الدالة [[Kotlin/kotlin.text/toMutableList|<code>toMutableList()</code>]]: تضيف كل محارف [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها إلى [[Kotlin/collections/List|قائمة متغيرة]]، إذ يوضع كل محرف في عنصر. |
− | * | + | * الدالة [[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/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 | + | [[تصنيف: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"))) // ı
}
انظر أيضًا
- الدالة
toHashSet()
: تحلّل كائنًا من النوعHashSet
يحوي كل محارف السلسلة التي استٌدعيت معها. - الدالة
toInt()
: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح. - الدالة
toMutableList()
: تضيف كل محارف سلسلة المحارف التي استٌدعيت معها إلى قائمة متغيرة، إذ يوضع كل محرف في عنصر. - الدالة
toRegex()
: تحول السلسلة النصية التي استٌدعيت معها إلى تعبير نمطي (regular expression). - الدالة
toSet()
: تضيف كل محارف سلسلة الحروف التي استٌدعيت معها إلى مجموعة من النوعSet
، إذ يوضع كل محرف في عنصر. - الدالة
toSortedSet()
: تضيف كل محارف السلسلة التي استٌدعيت معها إلى مجموعة من النوعSortedSet
، إذ يوضع كل محرف في عنصر. - الدالة
toString()
: تحول العدد الذي استٌدعي معها وفقًا لأساس مُحدّد إلى سلسلة نصية. - الدالة
toTitleCase()
: تحول المحرف الذي استٌدعي معها إلى محرف عنواني (titlecase). تتكون المحارف العنوانية عادةً من محرفين ملتصقين، مثل'Dž'
أو'Nj'
، إذ يعاملان وكأنَّهما محرفٌ واحدٌ فقط. - الدالة
toUpperCase()
: تحول المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف كبيرة (uppercase).