Swift Academy · درس

ثوابت السلاسل النصية متعددة الأسطر

اكتب نصًا متعدد الأسطر سهل القراءة باستخدام علامات الاقتباس الثلاثية.

ثوابت السلاسل النصية متعددة الأسطر درس مجاني في Swift Academy على CoddyKit. هذا هو الدرس 3 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Swift Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Swift Academy 4 دروس في المجموع.

القيم الحرفية النصية متعددة الأسطر

تمتد القيمة الحرفية النصية متعددة الأسطر على عدة أسطر. ويُحدَّد نطاقها بثلاث علامات اقتباس مزدوجة في سطرين مستقلين، ويحافظ النص بينهما على فواصل الأسطر.

let poem = """
Roses are red
Violets are blue
"""
print(poem)

الحفاظ على فواصل الأسطر

يصبح كل سطر جديد تكتبونه داخل القيمة الحرفية سطرًا جديدًا في السلسلة الناتجة، لذلك يُحافَظ على التنسيق كما هو تمامًا.

let menu = """
Coffee
Tea
Water
"""
print(menu)

إزالة المسافات البادئة

تحدد المسافات البيضاء قبل علامة الاقتباس الثلاثية الختامية مستوى المسافة البادئة الأساسي. وتزيل Swift هذا المقدار من المسافات البيضاء البادئة من كل سطر.

func describe() -> String {
    return """
    Title
    Body
    """
}
print(describe())

الإبقاء على بعض المسافات البادئة

تُحافَظ على المسافات البادئة التي تتجاوز المستوى الذي تحدده العلامة الختامية. ويتيح لكم ذلك إزاحة المحتوى المتداخل عمدًا.

let tree = """
Root
    Child
    Child
"""
print(tree)

دون سطر جديد في البداية أو النهاية

لا يُعد سطر الانفصال الموجود مباشرةً بعد """ الافتتاحية، ولا الموجود مباشرةً قبل """ الختامية، جزءًا من السلسلة النصية.

let s = """
Hello
"""
print("[\(s)]")

الاستيفاء في السلاسل متعددة الأسطر

تدعم القيم الحرفية متعددة الأسطر الاستيفاء مثل السلاسل ذات السطر الواحد تمامًا.

let name = "Sam"
let note = """
Dear \(name),
Welcome aboard.
"""
print(note)

إلغاء سطر جديد

يؤدي إنهاء السطر بشرطة مائلة عكسية إلى وصله بالسطر التالي، مع منع ظهور سطر جديد في المخرجات.

let joined = """
This is one \
long line
"""
print(joined)

علامات الاقتباس دون إلغاء

يمكنكم داخل قيمة حرفية متعددة الأسطر كتابة أحرف الاقتباس المزدوجة المفردة بحرية دون إلغاء.

let quote = """
She said "hello" today
"""
print(quote)

بناء القوالب

تُعد السلاسل النصية متعددة الأسطر مثالية للقوالب، مثل رسائل البريد الإلكتروني ومقتطفات الشيفرة أو التقارير المنسقة.

let user = "Lee"
let total = 42
let email = """
Hi \(user),
Your total is \(total).
Thanks!
"""
print(email)

الدمج مع التنسيق

يمكنكم استيفاء القيم المنسقة داخل القوالب متعددة الأسطر للحصول على مخرجات مرتبة ومتناسقة.

let price = 9.5
let receipt = """
Item: Coffee
Price: \(String(format: "%.2f", price))
"""
print(receipt)

لماذا نستخدم القيم الحرفية متعددة الأسطر

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

let help = """
Usage:
  run start
  run stop
"""
print(help)

تحقق سريع

تذكّروا كيفية التعامل مع المسافات البادئة.

مراجعة: القيم الحرفية النصية متعددة الأسطر

تعلّمتم أن القيم الحرفية المحددة بعلامات الاقتباس الثلاثية تحافظ على فواصل الأسطر، وأن إزاحة العلامة الختامية تحدد مقدار المسافات البيضاء البادئة التي تُزال، وأن سطري البداية والنهاية المحيطين لا يدخلان في القيمة، وأن الاستيفاء والشرطة المائلة العكسية الختامية لوصل الأسطر يعملان داخلها أيضًا.

let card = """
Name: Ada
Role: Engineer
"""
print(card)

الأسئلة الشائعة

هل درس «ثوابت السلاسل النصية متعددة الأسطر» مجاني؟

نعم — نص درس «ثوابت السلاسل النصية متعددة الأسطر» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Swift Academy، انتقل إلى CoddyKit PRO. تتضمن دورة Swift Academy 4 دروس في المجموع.

ماذا ستتعلم في «ثوابت السلاسل النصية متعددة الأسطر»؟

اكتب نصًا متعدد الأسطر سهل القراءة باستخدام علامات الاقتباس الثلاثية. تتمرن على Swift Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ Swift Academy؟

لا تُشترط خبرة سابقة. Swift Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 4.

كم من الوقت يستغرق درس «ثوابت السلاسل النصية متعددة الأسطر»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس Swift Academy هذا؟

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

جميع الدروس في هذه الدورة

← العودة إلى Swift Academy