Java Academy · درس

تعريف Text Blocks

اكتبوا سلاسل متعددة الأسطر باستخدام علامات الاقتباس الثلاثية

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

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

قبل Java 15، كانت كتابة نص متعدد الأسطر تعني ربط السلاسل باستخدام \n و+. وكان ذلك صعب القراءة وسهل الوقوع في الأخطاء. وتحل كتل النص هذه المشكلة.

علامات الاقتباس الثلاثية

تبدأ كتلة النص بثلاث علامات اقتباس مزدوجة """ تتبعها سطر جديد، ثم محتواك، ثم علامة الإغلاق """. وكل ما بينهما هو السلسلة النصية.

public class Main {
    public static void main(String[] args) {
        String message = """
            Hello
            World
            """;
        System.out.println(message);
    }
}

قاعدة السطر الافتتاحي

يجب أن يبدأ المحتوى في السطر الذي يلي """ الافتتاحية. ولا يمكنك وضع نص مباشرةً بعد محدد الافتتاح. فهذا السطر الجديد جزء مطلوب من الصياغة.

public class Main {
    public static void main(String[] args) {
        String poem = """
            Roses are red
            Violets are blue
            """;
        System.out.println(poem);
    }
}

الأسطر الجديدة تلقائية

يصبح كل فاصل أسطر في كتلة النص \n في السلسلة الناتجة. ولن تحتاج بعد الآن إلى كتابة تسلسلات الهروب لنهايات الأسطر.

public class Main {
    public static void main(String[] args) {
        String list = """
            Apples
            Bananas
            Cherries
            """;
        System.out.print(list);
    }
}

لا مزيد من الربط

قارن الطريقة القديمة ("a\n" + "b\n") بكتلة نص. تُقرأ كتلة النص تمامًا مثل الناتج، مما يجعل اكتشاف الأخطاء واضحًا.

public class Main {
    public static void main(String[] args) {
        String html = """
            <html>
              <body>Hi</body>
            </html>
            """;
        System.out.println(html);
    }
}

علامات الاقتباس دون تهريب

داخل كتلة النص، لا تحتاج علامات الاقتباس المزدوجة المفردة " إلى تهريب. وهذا مثالي للمحتوى الذي يحتوي على علامات اقتباس، مثل JSON.

public class Main {
    public static void main(String[] args) {
        String json = """
            {"name": "Alice", "age": 30}
            """;
        System.out.println(json);
    }
}

كتلة النص لا تزال String

الناتج هو String عادي. ويمكنك استدعاء أي دالة من دوال String عليه، أو ربطه، أو تمريره إلى دوال أخرى.

public class Main {
    public static void main(String[] args) {
        String text = """
            one
            two
            """;
        System.out.println("Length: " + text.length());
        System.out.println("Upper: " + text.toUpperCase());
    }
}

ربط كتل النص

يمكنك ربط كتلة نص بسلاسل نصية أخرى باستخدام +، تمامًا مثل أي ثابت نصي.

public class Main {
    public static void main(String[] args) {
        String name = "Bob";
        String greeting = """
            Dear customer,
            """ + "Welcome " + name;
        System.out.println(greeting);
    }
}

الحفاظ على الأسطر الفارغة

تظل الأسطر الفارغة داخل الكتلة أسطرًا فارغة في السلسلة النصية. ويتيح لك ذلك تنسيق الناتج ذي المسافات بشكل طبيعي.

public class Main {
    public static void main(String[] args) {
        String spaced = """
            Title

            Body text
            """;
        System.out.print(spaced);
    }
}

مقتطفات شيفرة سهلة القراءة

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

public class Main {
    public static void main(String[] args) {
        String config = """
            host = localhost
            port = 8080
            debug = true
            """;
        System.out.print(config);
    }
}

عدّ الأسطر

لأن الأسطر الجديدة حقيقية، يمكنك تقسيم كتلة النص عند \n لمعالجة كل سطر.

public class Main {
    public static void main(String[] args) {
        String data = """
            red
            green
            blue
            """;
        String[] lines = data.split("\n");
        System.out.println("Lines: " + lines.length);
    }
}

تحقق سريع

أين يجب أن يبدأ محتوى كتلة النص؟

مراجعة

تعلمت التصريح عن كتل النص:

افتحها وأغلقها باستخدام """
يجب أن يبدأ المحتوى في السطر التالي
تتحول فواصل الأسطر إلى \n تلقائيًا
لا تحتاج علامات الاقتباس المزدوجة إلى تهريب
الناتج هو String عادي

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

هل درس «تعريف Text Blocks» مجاني؟

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

ماذا ستتعلم في «تعريف Text Blocks»؟

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

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

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

كم من الوقت يستغرق درس «تعريف Text Blocks»؟

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

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

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

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

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