שתפו את ההערה הכי הזויה שלכם!

BravoMan

Active member
שתפו את ההערה הכי הזויה שלכם!

בזמן האחרון יש מעט מאוד תנוע בפורום.

חשבתי קצת איך לעורר פה עניין, ונזכרתי שיש לא מעט משתמשים וותיקים כמוני שקוראים פה, אבל כמעת אף פעם לא שואלים שאלות ולא פותחים שרשורים.

ואז בא לי רעיון:
נפתח שרשור ונשתף פה את ה-comments הכי הזויים, מצחיקים, לא יעילים, ואולי אפילו מזיקים שיצא לנו לכתוב בעצמנו.

מסוג הדברים שאתה מסתכל עליהם בדיעבד בקוד וחושב: WTF was I thinking???

וכמובן, כדי להראות שאני רציני ולא סתם זורק דברים באוויר, אתחיל לא מאחת, אלא משתי דוגמאות אישיות שלי שהיו כ"כ דפוקות, שאני זוכר אותן עד היום!

1. "נכון שאני חכם?"
פעם, הייתי צריך לשנות פונקציה בשפת C שחיה בספריה מערכתית כלשהי.
בגלל שמדובר בפונקציה מערכתית, היכולת לשנות היית מאוד מוגבלת, והיו אילוצים שונים ומשונים.

חלק מהשינוי היה להקצות 2 buffers בצורה דינמית בכל כניסה לפונקציה ולשחרר לפני יציאה ממנה.

ידעתי שהקצאות קטנות מרובות כאלה לא ממש עושים טוב למערכת, אבל הדרך היחידה שמצאתי לצמצם את כמות ההקצאות היית לאחד את הבאפרים להקצאה אחת.

זה הפך את הקוד ללא אינטואיטיבי (בעיני), ולכן הרגשתי צורך להוסיף הערה שמסבירה מה עשיתי:
//aren't I clever?


2. "יותר הערות פחות קוד!"
לפני הרבה שנים במגמת מחשבים בתיכון קיבלנו תרגיל שבו היה צריך לבצע מספר פעולות עם רשימה מקושרת.

המורה ביקשה שנממש את התרגיל עם כמה שפחות משתנים, כדי שנלמד על יעילות זיכרון.

אחרי ששברתי את הראש קצת, הגעתי למסקנה שאם אני משרשר את הרשימה בסדר הפוך, אני חוסך משתנה אחד.

אבל השיטה הזו נראתה לי כ"כ מסובכת, שכתבתי הערה מפורטת שמסבירה מה עשיתי.

הבעיה?
ההערה לקחה מסך שלם (עורך Turbo Pascal ב-DOS)!

מיותר לציין שהמורה לא התלהבה מזה


יש לכם סיפורים דומים?
או לפחות נתקלת בחיים האמתיים בקוד עם הערות שכאלה?

שתפו!
 

ai21

New member
פעם יצא לי לכתוב קוד באסמבלר שיועבר לצוות דרייבר

הלכתי לאנשי הדרייברים וחילצתי מהם הנחות יסוד,
אחת מהן הייתה שפקטה לא תהיה קצרה מDWORD.

לאחר שהבנתי שההבדל בביצועים יהיה משמעותי (ועניין הביצועים היה קריטי, אחרת לא היינו משכתבים לאסמבלי) - כתבתי את הקוד תוך הנחה שהיא אכן קצרה - והכנסתי הערת אזהרה מאיימת במיוחד בנוגע להנחות היסוד לקוד,
ובה - גם את קטעי הקוד שצריך להוסיף במצב בו הנחות היסוד היו שגויות - והעברתי לצוות דרייברים.

שנה לאחר מכן הופיע באג, בו בפרוטוקול מסויים היו הרבה שגיאות, ולאחר שלא הצליחו לפתור אותו, ביקשו ממני למצוא מהו.
מסתבר - שהתקשו לזהות את הבאג,
כי הסירו את האזהרה המאיימת, עם הקוד הנדרש לתיקון,
כנראה בגלל שהנוסח היה מלחיץ מדי.
 
למעלה