الفريق العربي للبرمجةأرشيف المنتديات · 2000 – 2023
نسخة أرشيفية للقراءة فقط — التسجيل والمشاركة مغلقان، والمحتوى محفوظ كما كان.

مطلوب مساعدة في كتابة التعليقات على الكود

مغلق
بدأه صلاح الثبيتي في 31 ديسمبر 2002 · 8 رد · 726 مشاهدة · في JavaSE
مشاركة: واتساب X فيسبوك تيليجرام
#1 صاحب الموضوع

السلام عليكم :)

بغيت مساعده بسيطه في كتابة التعليقات على الكود بشكل مفهوم،،

فرضاً لو ابغى اكتب تعليق على هذا القسم من الكود،،، 

/**
 *If we want to write a new text, first we want to know if the text area is empty or not,
 *second we want to kwnow if the text was saved or not.
 *If the text area isn't empty & the text wasn't saved befor this time, then the program display
 *for the user an option for saving the text in a new file or not...
 */
public void neW(){
	if(!n.getTextArea().getText().equals("") && !n.getTextArea().getText().equals(fileContent)){
		if(fileName == null){
			option = JOptionPane.showConfirmDialog(null,"Do you want to save the changes ??");
			if(option == 0){
				//to save the text into the file
				saveAs();
				//to create new getTextArea() after saving the old getTextArea()
				n.getTextArea().setText("");
			}
			if(option == 1){
				//to create new getTextArea() without saving the old getTextArea()
				n.getTextArea().setText("");
			}
		}
		else{
			option = JOptionPane.showConfirmDialog(null,"Do you want to save the changes ??");
			if(option == 0){
				save();
				//to create new getTextArea() after saving the old getTextArea()
				n.getTextArea().setText("");
			}
			else{
				if(option == 1){
					//to create new getTextArea() without saving the old getTextArea()
					n.getTextArea().setText("");
				}
			}
		}
	}
	else{
		n.getTextArea().setText("");
	}
}

ابغى اعرف احسن طريقة لكتابة التعليق بشكل مفهوم و بسيط ..

™The source code for JNotepad, JGPA & JLibrary - Java

#2

السلام عليكم ,,,

صلاح الله يعينك في إختباراتك و يوفقنا جميعاً يا رب :)

سؤالك هذا يعتبر فلسفه شخصيه لكل واحد وجهت نظر فيها :)

أنا أشوف في البرامج الكبيره جداً أنك تكتب التعليقات بعد كل مجموعة

اسطر تنفذ عمليه معينه و هكذا لأنه بعد ان تترك العمل على المشروع لفتره

و تريد العوده عليه صدقني ستنسى كل شيئ :cool:

و اكتب تعليق عند نهاية كل قوس تبين لتبع من هذا القوس يعني تقول

للـ if الفلانيه أو للـ while الفلانيه خصوصاً إذا كنت تستخدم بلوكات كبيره

نوعاً ما.

و في النهاية المفروض تخلي اللي يقرى التعليقات حقت البرنامج

يحس انه شرح مفصل لطريقة عمل الكود :)

هذي هي فلسفتي في البرامج الكبيره نوعاً ما ...

أخوك / طلال.

#3

السلام عليكم :)

مشكور على ردك :) :) :) ما توقعت انك ترد على موضوعي :P

وش رايك بالتعليق على الكود السابق ؟؟ كافي او يبغى له شرح زياده ؟؟؟

™The source code for JNotepad, JGPA & JLibrary - Java

#4

بسم الله الرحمن الرحيم

هلا (f) talal*c (f)

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

لكن من وجهة نظرى الشخصية عند كتابة تعليق على دالة كاملة يفضل ان تكتب بجانب التوضيح النصى خطوات أو خوارزمية الحل بأسلوب 1 , 2 , 3.... حتى يكون لك مرجعا فيما بعد.

لكن بصفة عامة التعليق واضح مما انعكس على وضوح الكود ;)

#5

السلام عليكم ,,,

صلاح وش دعوى ؟ أنا أحرص كثيراً على الرد على مواضيعك ;)

و التعليق اللي كتبته جداً رائع شوف هذا مثال كتبته لكلاس لنك لست

كتبته لمشروع الـ OS :

int LinkList::del_last(event_data &z)

{

	ptr p;



	if(this->head == NULL)  /* if empty list */

	{

  printf("nSory no list...");

  return 0;

	}

	else  /* else the list is not empty */

	{

  if(this->head->next == NULL)  /* is there only one node ? */

  {

 	 z = this->head->ldata;

 	 free(this->head);

 	 this->head = NULL;

  }

  else  /* the list has many nodes */

  {

 	 p = this->head;



 	 while(p->next != NULL)

    p = p->next;

 	 /* in the end of the loop the pointer p will point to the last node */



 	 z = p->ldata;	/* get z value */

 	 p->prev->next = NULL;     /* the node befor the last node will point to NULL 

                                 becuse it will be the last node */

 	 free(p);      /* destroy the last node (p) */

  }

	}

	(this->size_of_queue)--;   /* decrementing the size by 1 */

	return 1;    /* the node has been deleted */

}

أخي خالد:

كيفك من زامن و الله (f)

كلامك صحيح 100% و انا أقدر أقول لا :D

أخوكم / طلال.

#6

خليها على ربك،، يمكن احذف هذا السمستر على نهايته :( ...

لكن خليني استخير و افكر بالموضوع :'(

™The source code for JNotepad, JGPA & JLibrary - Java

#7

السلام عليكم

يا صلاح وش دعوى إن شاء الله المانع خير ؟!!

المهم يا صلاح استخر ربك و ترى الحذف ما فيه شي بالعكس ممكن يكون

نجاح في كثير من الاحيان :)

أنا ما احس اني تمكنت من السي إلا لما حذفت ثاني فصل عندي بسبب

السي و الان أحمد ربي ألف مره على أني حذفت الفصل :)

أنت استخر و شوف اللي يناسبك بس بسررررررعه لأنه عندنا إنتهى الحذف

ما ادري عنكم ؟!!!

عجل ترى الوقت محدود :)

ملاحظه:

ما راح تاخذ في كل موادك الدرجة التي تستحقها مادام نحن في جامعات عربيه.

<--- كلام مجرب.

#8

السلام عليكم :)

كلامك صحيح يا طلال،،،، انا عندي ماده هندسه كمبيوتر .. يعني ماهي بالتخصص و لا فاهم فيها شئ ... يعني الشغله كلها كهرباء و 0 و 1 ...

™The source code for JNotepad, JGPA & JLibrary - Java

هذا الموضوع مغلق.

مواضيع مشابهة

عدد الزوار حالياً

المتواجدون خلال آخر دقيقتين · يتحدّث كل ٣٠ ثانية

—الإجمالي—أعضاء مسجّلون—زوار بدون تسجيل

جارٍ التحقق من المتواجدين…