ملاحظات Java

أنت تريد ملاحظة داخل الملف لنفسك، وتريد أن تبقى الشاشة كما هي. الشاشة ما زالت mint. الملاحظة لمن يقرأ Mint.java. ليست كلمة للشاشة. هذه الصفحة تضع تلك الملاحظة بشكلين، وتبيّن أن mint ما زال السطر الوحيد، ثم تبيّن الموضع الوحيد الذي يمسح mint من الشاشة. أنت لا تثبّت Java من جديد. أنت لا تبحث عن السطر الذي يكتب الشاشة. أنت تعرف أن ذلك السطر هو System.out.println("mint"). العمل الجديد هو الملاحظة بجانبه.

الملاحظة ليست أمرًا

الأمر سطر تنفّذه Java. System.out.println("mint") أمر. يكتب mint وينهي السطر. الملاحظة نص تتركه في الملف لتتذكر شيئًا، أنت أو القارئ التالي. Java تتجاوز الملاحظة. التجاوز يعني أن الملاحظة لا تُنفَّذ، وأنها لا تُكتب على الشاشة. حروف الملاحظة تبقى في الملف بعد التشغيل. تستطيع أن تفتح Mint.java وتقرأها. لا تجدها على الشاشة. الشاشة ما زال فيها سطر واحد، وذلك السطر mint، ما دام أمر الكتابة نفسه ليس هو الملاحظة.

هناك شكلان. الملاحظة السطرية تبدأ بخطين مائلين: //. Java تتجاوز من هذين الخطين حتى نهاية السطر نفسه. السطر التالي يعود سطرًا عاديًا. الشكل الآخر يبدأ بـ / وينتهي عند أول /. Java تتجاوز كل ما بين هاتين العلامتين، بما في ذلك الانتقال إلى السطر التالي. هذه الملاحظة قد تكون في سطر واحد أو في عدة أسطر. الشكلان كلاهما ملاحظات. لا أحد منهما يكتب الشاشة. الخطوط المائلة لا تُطبع. النجوم لا تُطبع. الكلمات التي تضعها بينهما لا تُطبع.

الملف الذي تحتفظ به

احفظ هذا باسم Mint.java. هذا هو الملف الذي تحتفظ به هذه الصفحة. فيه ملاحظة سطرية فوق أمر الكتابة، وملاحظة سطرية على سطر أمر الكتابة نفسه، وملاحظة سطرية فوق main. أمر الكتابة ما زال موجودًا، وهو ليس خلف خط مائل.

اقرأ من الأعلى، وقرّر لكل سطر هل تتلقاه الشاشة أم لا. السطر الأول ما زال public class Mint. أنت تعرف أن هذا السطر يسمّي الملف ولا يكتب الشاشة. السطر التالي هو // the file is named Mint.java. الخطان المائلان يبدآن ملاحظة، فكلمات the file is named Mint.java لك أنت. الشاشة لا تعرضها. ولا تعرض الخطين المائلين أيضًا. السطر public static void main(String[] args) هو المكان الذي تبدأ منه Java، ولا كلمة من تلك الكلمات على الشاشة. هذا لم يتغيّر.

داخل main، السطر // a note for the reader ملاحظة فقط. تصل Java إليه، تتجاوزه، وتنتقل إلى السطر التالي. السطر التالي هو السطر المهم: System.out.println("mint"); // the screen is this word. اقرأ هذا السطر قطعتين يفصلهما الخطان المائلان. قبل الخطين، الأمر هو System.out.println("mint");. هذا الأمر يكتب mint وينهي السطر. بعد الخطين، كلمات the screen is this word ملاحظة. هي على السطر نفسه مع الأمر، ومع ذلك تُتجاوز. ليس لازمًا أن تحتل الملاحظة سطرًا وحدها. إذا كتبت // بعد أمر انتهى، يُنفَّذ الأمر ولا يُنفَّذ باقي السطر. الفاصلة المنقوطة هي التي تُنهي الأمر. الخطان بعد الفاصلة المنقوطة يبدآن الملاحظة. اترك الفاصلة المنقوطة مكانها. الشاشة تعرض mint. لا تعرض the screen is this word. ولا تعرض سطرًا ثانيًا.

شغّله بالطريقة نفسها. في المجلد الذي فيه هذا Mint.java، اكتب javac Mint.java. حين يكون الملف سليمًا، هذا الأمر لا يكتب أي سطر. الملاحظات لا تجعل javac يكتب سطرًا، ولا تجعله يفشل. ثم اكتب java Mint. لا تكتب .java بعد java. الشاشة تعرض mint. سطر واحد. بلا علامتي اقتباس. بلا خط مائل. بلا سطر ثانٍ. كلمة mint ما زالت الكلمة التي بين علامتي الاقتباس. ليست كلمة كتبتها في الأمر، وليست كلمة كتبتها في ملاحظة.

ملاحظة بين / و /

هذا هو الشكل الآخر. تستخدمه حين تكون الملاحظة أطول من سطر، أو حين تريد أن تكون نهاية الملاحظة علامة تختارها أنت، لا نهاية السطر. علامة البداية /. علامة النهاية /. Java تتجاوز من البداية حتى النهاية، وأول / هو النهاية. أي / لاحق ليس جزءًا من هذه الملاحظة، لأن الملاحظة انتهت قبل ذلك. هذه الصفحة تستخدم ملاحظة واحدة من هذا الشكل، فترى بداية واحدة ونهاية واحدة.

استبدل الملاحظات السطرية داخل main بملاحظة واحدة من هذا الشكل، واترك أمر الكتابة مكانه. الشاشة لا تتغيّر. هذا هو الملف الثاني. أنت تنظر إلى شكل الملاحظة. الملف الذي كنت تحتفظ به استخدم ملاحظات سطرية. هذا الملف يستخدم ملاحظة بين / و /. كلاهما يكتب mint.

تبدأ الملاحظة في السطر الذي يبدأ بـ /. كلمات a note داخله. السطر التالي، across two lines، داخله أيضًا، لأن / الختامية لم تُكتب بعد. / في آخر ذلك السطر الثاني تنهي الملاحظة. ثم تنفّذ Java الأمر System.out.println("mint"); لأن هذا الأمر خارج الملاحظة، تحت علامة النهاية. الشاشة تعرض mint. كلمات a note و across two lines ليست على الشاشة. النجوم والخطوط المائلة ليست على الشاشة. إذا نقلت / إلى الأعلى لتجلس على السطر الأول، مباشرة بعد a note، فالسطر الثاني لم يعد داخل الملاحظة. ذلك السطر الثاني يجب أن يكون سطر Java حقيقيًا، و across two lines ليس أمرًا. عندها يكتب javac خطأً بدل أن يبقى صامتًا. في هذه الصفحة تبقى */ في آخر السطر الثاني، فتُتجاوز الملاحظة كلها ويبقى javac صامتًا.

لا تحاول أن تضع ملاحظة من هذا الشكل داخل ملاحظة أخرى. أول / ينهي الملاحظة، حتى لو كنت تقصد أن تنهي / تلك ملاحظة داخلية. بعد علامة الإغلاق الأولى، Java تقرأ أوامر من جديد. هذه الصفحة لا تضع ملاحظة داخل ملاحظة. بداية واحدة، نهاية واحدة، ثم أمر الكتابة.

الخطأ الذي يمسح mint

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

javac Mint.java ما زال لا يكتب أي سطر، لأن ملفًا يكتفي بتجاوز ملاحظة ملف صالح. تبدأ Java عند main، وتتجاوز السطر الوحيد داخله، وتنتهي. ثم java Mint لا يكتب شيئًا. لا mint. لا كلمة فارغة بين علامتي اقتباس. لا سطر ثانٍ. الشاشة فارغة لأن الأمر الذي كان يكتب mint صار خلف //. الحروف System.out.println("mint") ما زالت في الملف، وتستطيع قراءتها، لكنها ملاحظة الآن. علامتا الاقتباس لا تنقذانها. علامتا الاقتباس تحدّدان كلمة داخل أمر. لا تعيدان ملاحظة إلى أمر. الخطان المائلان في الأمام هما اللذان يقرران، ويقرران أن بقية السطر للقارئ.

أعد الملف إلى الذي تحتفظ به. سطر الكتابة يجب أن يكون System.out.println("mint"); والملاحظة، إن أردتها، بعد الفاصلة المنقوطة. عندها يكتب java Mint كلمة mint من جديد. إذا كانت الشاشة فارغة، فابحث عن // قبل System.out. هذا هو الفحص كله. لا تعيد تثبيت Java لشاشة فارغة سببها ملاحظة.

الملاحظة قد تحتوي أي كلمات، بما فيها Mint و main و mint. هذه الكلمات مع ذلك ليست على الشاشة. الشاشة تستخدم الكلمة التي بين علامتي اقتباس في أمر يُنفَّذ فعلًا. في الملف الذي تحتفظ به، تلك الكلمة mint، بميم صغيرة. ملاحظة تقول Mint، بميم كبيرة، لا تجعل الشاشة تعرض Mint. ملاحظة تكرر mint لا تكتب سطرًا ثانيًا. التشغيل لا يحذف الملاحظة من الملف. افتح الملف بعد java Mint والملاحظة ما زالت هناك.

أنت الآن تستطيع أن تضع ملاحظة في Mint.java من غير أن تغيّر الشاشة. الملاحظة السطرية تبدأ بـ //. الملاحظة بين / و / تبدأ بـ / وتنتهي عند أول /. شاشة الملف الذي تحتفظ به هي mint، ويكتبها System.out.println("mint"). إذا وقفت // أمام ذلك الأمر، فالشاشة بلا سطر. الصفحة التالية تغيّر الكلمة التي بين علامتي الاقتباس، فتعرض الشاشة كلمة مختلفة. ملاحظات هذه الصفحة تبقى ملاحظات.

الشاشة ما زالت mint

الملف الذي تحتفظ به يكتب mint. الملاحظات التي تبدأ بـ // ليست على الشاشة. الملاحظة بين / و / ليست على الشاشة. أول */ ينهي تلك الملاحظة. الشاشة فيها سطر واحد. لا سطر ثانٍ.