کامنت‌های جالب در کد

اگر برای یک پروژه بزرگ کد زده باشید یا مجبور به خواندن یا تغییر کد دیگران شده‌باشید بیش از پیش اهمیت کامنت را در تسریع فهم کد و تغییرات آتی درک کرده‌اید اما گویا کامنت‌ها همیشه چنین مفهومی را در برندارند!

احتمالا خود شما نیز گاهی عصبانیت‌ها، خستگی‌ها و افکاری که حین نوشتن کد به ذهنتان می‌رسد را به صورت کامنت در کد آورده‌اید یا پیام‌هایی را برای خوانندگان آتی کد خود یادداشت کرده‌اید. در ادامه چند نمونه از کامنت‌های جالب در کد را آوردیم.

۱- در کد زیر کامنتی به زبان غیرانگلیسی نوشته شده است که ترجمه آن این است:

این شرکت هیچ پاداشی نمی‌دهد، آن را فراموش کنید. به این شرکت نیایید! من دارم ترک می‌کنم!
این پروژه باگ‌های زیادی دارد. خیلی دوام نخواهید آورد! خداحافظ! موفق باشید!

۱- رزومه Sergey Brin، از موسسین شرکت گوگل، وقتی که دانشجوی PhD علوم کامپیوتر استفورد بوده است را اگر مشاهده کنید هیچ اعتراض و شکایتی در آن مشاهده نمی‌شود اما وقتی کد منبع html آن را نگاه کنید تصویر زیر را مشاهده خواهید کرد.

۲- در کدی که در انتشار ششمین نسخه unix در آزمایشگاه Bell منتشر شد، کامنت زیر دیده می‌شود که گفته شده انتظار نمی‌رود که شما این را متوجه شوید!

/* You are not expected to understand this */

تکه کد آن نیز در ادامه آمده است.

/*
 * Switch to stack of the new process and set up
 * his segmentation registers.
 */
 retu(rp->p_addr);
 sureg();
/*
 * If the new process paused because it was
 * swapped out, set the stack level to the last call
 * to savu(u_ssav).  This means that the return
 * which is executed immediately after the call to aretu
 * actually returns from the last routine which did
 * the savu.
 *
 * You are not expected to understand this.
 */
 if(rp->p_flag&SSWAP) {
   rp->p_flag =& ~SSWAP;
   aretu(u.u_ssav);
  }
 /*
 * The value returned here has many subtle implications.
 * See the newproc comments.
 */
 return(1);

۳- لینک‌های زیر را باز کرده و خودتان در مرورگر کد منبع آن‌ها را مشاهده کنید 🙂 این کار در گوگل کروم با کلیک راست و انتخاب گزینه view page source انجام می‌گیرد.

http://theoatmeal.com و

http://www.lingscars.com

۴- چند نمونه دیگر از کامنت‌های جالب بر اساس مشاهدات کاربران استک اور فلو

// I am not responsible of this code. 
// They made me write it, against my will.

long long ago; /* in a galaxy far far away */

//When I wrote this, only God and I understood what I was doing
//Now, God only knows

Exception up = new Exception("Something is really wrong."); 
throw up; //ha ha

// 
// Dear maintainer:
// 
// Once you are done trying to 'optimize' this routine,
// and have realized what a terrible mistake that was,
// please increment the following counter as a warning
// to the next guy:
// 
// total_hours_wasted_here = 42
//

۵- شرکت‌هایی هم هستند که از طریق کامنت نهفته در کد سایتشان اقدام به استخدام نیرو می‌کنند!

شرکت flipkart که یک زمانی، بعد از inspect element در مرورگر، در بخش کنسول، شکل زیر مشاهده می‌شد:

اگر دقیق‌تر متن نوشته شده را ببینیم آگهی استخدام در شرکت است. جالب نیست؟!

سایت snapdeal هم به طور مشابه چنین چیزی داشته است:

۶- کامنت‌های بیهوده‌ای هم هستند که گاهی احساس می‌کنیم نویسنده کد قصد تمسخر داشته است!

$i = 0; //set i to 0

$i++; //use sneaky trick to add 1 to i!

if ($i==$j) { // I made sure to use == rather than = here to avoid a bug 
// remember to comment code

return 1; // returns 1

شما با چه کامنت‌های جالبی روبرو شده‌اید؟ خودتان چه چیزهای جالبی را کامنت کرده‌اید؟ 🙂

منابع:

http://stackoverflow.com/

http://stackoverflow.com/

https://www.quora.com/