السلاسل النصية الخام وعلامات الاقتباس الثلاثية
استخدم السلاسل النصية المحاطة بعلامات اقتباس ثلاثية للنصوص متعددة الأسطر والمحتوى الخام من دون محارف هروب.
السلاسل النصية الخام وعلامات الاقتباس الثلاثية درس مجاني في Kotlin Academy على CoddyKit. هذا هو الدرس 3 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Kotlin Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Kotlin Academy 4 دروس في المجموع.
ما السلسلة النصية الخام؟
تستخدم السلسلة النصية الخام ثلاث علامات اقتباس """...""" وتحافظ على النص تمامًا كما كُتب — من دون تسلسلات هروب أو محارف خاصة.
سلسلة نصية خام أساسية
يمكن للسلاسل المحاطة بثلاث علامات اقتباس أن تمتد على عدة أسطر من دون كتابة \n صراحةً.
fun main() {
val text = """
Line 1
Line 2
Line 3
"""
println(text)
}لا حاجة إلى تسلسلات هروب
تظهر الشرطات المائلة العكسية وعلامات الاقتباس حرفيًا داخل السلسلة النصية الخام. وهذا مثالي لأنماط regex ومسارات Windows.
fun main() {
val regex = """\d+\.\d+"""
val winPath = """C:\Users\Alice\Documents"""
println(regex)
println(winPath)
}JSON متعدد الأسطر
تُعدّ السلاسل النصية الخام مثالية لتضمين ثوابت JSON أو SQL أو HTML — من دون فوضى محارف الهروب.
fun main() {
val json = """
{
"name": "Kotlin",
"year": 2011
}
""".trimIndent()
println(json)
}trimIndent()
تزيل trimIndent() المسافات البيضاء البادئة المشتركة من كل سطر، مما يتيح لكم تنسيق المصدر بمسافات بادئة مناسبة مع الحفاظ على ناتج نظيف.
fun main() {
val poem = """
Roses are red
Violets are blue
Kotlin is sweet
And so are you
""".trimIndent()
println(poem)
}trimMargin()
تزيل trimMargin() علامة الهامش البادئة (والافتراضية هي |). استخدموها عندما تكون المحاذاة الصريحة أفضل من مطابقة المسافات البادئة.
fun main() {
val msg = """
|Hello,
| World!
|Goodbye.
""".trimMargin()
println(msg)
}حرف الهامش المخصص
مرّر أي حرف إلى trimMargin لتخصيص العلامة.
fun main() {
val text = """
>Line A
>Line B
""".trimMargin(">")
println(text)
}تظل قوالب السلاسل النصية تعمل
تستمر السلاسل النصية الخام في استيفاء $variable و${expression}. يتم تعطيل تسلسلات الهروب فقط.
fun main() {
val name = "Kotlin"
val version = 1.9
val report = """
Name: $name
Version: $version
Build: ${if (version >= 1.0) "stable" else "beta"}
""".trimIndent()
println(report)
}إدراج علامات الاقتباس الحرفية
لا تحتاج علامات الاقتباس المزدوجة داخل السلاسل النصية المحاطة بثلاث علامات اقتباس إلى الهروب — اكتبها كما هي.
fun main() {
val quote = """She said, "Hello!" and smiled."""
println(quote)
}إدراج علامة الدولار حرفيًا
لإدراج $ حرفية داخل سلسلة نصية خام، استخدم حيلة القالب: ${'$'}.
fun main() {
val price = """Cost is ${'$'}100"""
println(price) // Cost is $100
}تطبيق عملي: استعلام SQL
تحافظ السلاسل النصية المحاطة بثلاث علامات اقتباس على قابلية قراءة استعلامات SQL الطويلة في المصدر.
fun main() {
val table = "users"
val sql = """
SELECT id, name, email
FROM $table
WHERE active = true
ORDER BY name
""".trimIndent()
println(sql)
}تحقق سريع
ما الدالة التي تزيل المسافات البيضاء المشتركة في بداية كل سطر من سلسلة نصية خام؟
مراجعة
تحافظ السلاسل النصية المحاطة بثلاث علامات اقتباس على النص حرفيًا (من دون تسلسلات هروب) وتمتد عبر عدة أسطر. استخدم trimIndent() أو trimMargin() لتنظيف المسافة البادئة. تظل القوالب تعمل، بينما تحتاج $ الحرفية إلى ${'$'}.
الأسئلة الشائعة
هل درس «السلاسل النصية الخام وعلامات الاقتباس الثلاثية» مجاني؟
نعم — نص درس «السلاسل النصية الخام وعلامات الاقتباس الثلاثية» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Kotlin Academy، انتقل إلى CoddyKit PRO. تتضمن دورة Kotlin Academy 4 دروس في المجموع.
ماذا ستتعلم في «السلاسل النصية الخام وعلامات الاقتباس الثلاثية»؟
استخدم السلاسل النصية المحاطة بعلامات اقتباس ثلاثية للنصوص متعددة الأسطر والمحتوى الخام من دون محارف هروب. تتمرن على Kotlin Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ Kotlin Academy؟
لا تُشترط خبرة سابقة. Kotlin Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 4.
كم من الوقت يستغرق درس «السلاسل النصية الخام وعلامات الاقتباس الثلاثية»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس Kotlin Academy هذا؟
نعم. كل درس في Kotlin Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- أساسيات String: القيم الحرفية وتسلسلات الهروب والطول
- قوالب String: $variable و${expression}
- السلاسل النصية الخام وعلامات الاقتباس الثلاثية
- أهم دوال السلاسل النصية: trim وsplit وreplace وcontains