[Powered by Google Translate] در این فیلم، ما سبک کد، بحث در مورد چیزی است که که به قلب من نزدیک است و عزیز است. سبک توضیح می دهد چگونه کد شما فرمت شده است، که مستقل از چه کد در واقع انجام می دهد. نه تنها سبک خوب را به شما نمره بهتر در CS50، اما آن را نیز فعال است که خیلی بیشتر نوشتن به شما کمک کند خواندن و نگهداری، که در پایان روز، رفتن به زندگی شما بسیار آسان تر است. 

سه مؤلفه اصلی سبک کد است که ما بحث خواهیم کرد این فیلم نظرات، قالب، و نام متغیر است. بیایید شروع با نظر. به یاد داشته باشید، هیچ تاثیری بر روی عملکرد کد شما. آنها فقط به عنوان نکات مفید به ما به عنوان برنامه نویسان خدمت می کنند. نظرات خوب باید یکی از دو پرسش پاسخ دهد. 

اول، چه این بلوک از کد انجام دهید؟ این شرح کوتاه و شیرین از هدف است خطوطی که به دنبال. برای مثال، شما ممکن است نیاز به جایی که شما برای پیدا کردن پیاده سازی یکی از ویژگی های خاص به رفع اشکال و یا چیزی را تغییر دهید. بدون نظر، شما ممکن است به منافذ بیش از بسیاری از خطوط نیاز کد تلاش برای کشف کردن دقیقا همان جایی که ویژگی است. یا اگر آن را چند روز بعد از اینکه تو در یکی از نگاه برنامه های خود را، شما ممکن است به یاد داشته باشید آنچه خاص تابع یا حلقه می کند. بنابراین نظرات را reacquainting خود را با کد قدیمی، و یا آشنا خود را با شخص دیگری کد، بسیار نرم و صاف است. سوال دوم پاسخ نظر خوب است چرا من پیاده سازی این بلوک را در این راه؟ همانطور که شما نوشتن کد، شما اغلب نیاز خواهید داشت برای ایجاد تصمیمات طراحی است. باید در حالی که حلقه یا حلقه for استفاده کنم؟ باید از این بلوک از کد من را به یک تابع جداگانه؟ با استفاده از نظرات، شما می توانید به طراحی خود را مستند کنید تصمیم گیری، که باعث می شود کد شما آسان تر به درک برای دیگران، که ممکن است درخواست خود را به یکسان سوالات طراحی به عنوان کد خود را به خواندن. یا حتی خودتان، اگر شما دوباره به یک بلوک از کد پس از برخی از دوره از زمان. 

در C، و به زبان های دیگر ما دیدن CS50، وجود دارد دو راه اضافه کردن نظرات به کد خود را، در خط نظر و چند خط توضیح. نظر در خط بزرگ برای مستند سازی قطعه از کد در داخل توابع. به عنوان مثال، یک خط در نظر می تواند توصیف هدف از حلقه و یا گوشه ای مورد لزوم توجه به وضعیت. چند خط نظر بزرگ برای مستند توابع. هر زمان که شما نوشتن یک تابع، شما باید همیشه، همیشه، همیشه به آنچه که آن را با یک نظر سند. این شامل چه ورودی به تابع هستند، چه خروجی از تابع است، و شاید به همین دلیل تابع در راه آن است که اجرا شده است. هر زمان که شما تغییر امضا یک تابع، بازگشت ارزش، و یا اجرا، این مهم را نیز به روز رسانی نظر مستندات مربوطه. عدم تطابق بین یک تابع نظر و پیاده سازی می تواند واقعا گیج کننده را برای خوانندگان است. به طور مشابه، ایجاد چند خط نظر در بالای هر یک از C یا فایل H تو می نویسم، شرح آنچه را که فایل را می کند، ایده بسیار خوبی است. 

همانطور که شما در حال بیان دیدگاه با کد خود را، یکی از اولین سوالات شما ممکن است داشته باشد، به خوبی، چقدر باید کد من نظر؟ این اغلب غیر ضروری به سند هر خط از کد. به عنوان مثال، یک خط که می گوید نوع int x = 5 می کند لازم نیست نظر خود را در مورد آن این است که می گوید: "X تا 5". اظهار نظر کافی نیست، هر چند، به عنوان دیده ایم، می تواند باعث درک کد شما بسیار دشوار است. بنابراین یک قاعده ی و خوب این است که به نظر بلوک های جالب فعال، که در آن یک بلوک شامل چند خط است. 

بنابراین به عنوان مثال به شما اجازه می دهد تا. در اینجا تابع uncommented C است. خوب، از آنجایی که این یک تابع است، اولین چیزی که ما نیاز به اضافه کردن یک نظر توضیح آنچه که ورودی تابع است هستند و آنچه در آن است. بنابراین اضافه کردن یک نظر چند خط به شما اجازه می دهد تا. بزرگ است. در حال حاضر ما می دانیم که دقیقا همان چیزی است که عملکرد ما به. اجازه دهید اضافه کردن برخی از نظرات در خط در حال حاضر. ما می توانید کد خود را به دو بلوک از خطوط مشابه تقسیم. خطوط 4 و 5 رشته سازه در ورودی و بر اساس خطوط 6 تا 9 خروجی کسانی که رشته درون متن آهنگ. پس اجازه دهید که با نظر سند. عالی است. در حال حاضر تابع ما این است که اظهار نظر است. 

توجه داشته باشید که در نظر ما لازم نیست برای استفاده کامل جملات و یا با پایان یک دوره است. این مهم است که یک فضای بین اسلش دوم وجود دارد و شروع از نظر. این فرکانس از نظر درون برنامه های خود است که شما باید در تیراندازی. در اینجا توجه داشته باشید که ما چگونه از هم جدا دو بلوک از کد مربوط به در داخل تابع کر ما با یک بازگشت نورد اضافی. 

این ما را به جزء بعدی از سبک کد، قالب بندی. هنگامی که من برای اولین بار شروع به برنامه نویسی، من ضربه را وارد کنید کلیدی به ندرت، که منجر به غول پیکر، خواندن حباب کد. من فکر می کنم من در واقع به جرم همکار آموزش من، از او خیلی خوشحال بود با من نیست. بصری گروه بندی بلوک از کد مربوطه، با استفاده از حمل و نقل برمی گرداند، و باعث می شود که کد خود را آسان تر به کف و به طور واضح ترسیم که خط از کد نظرات خود را توضیح می دهد. که می شود گفت، گسترش از کد شما خیلی زیاد است، به عنوان با دو یا بیشتر از خطوط بین بلوک های کد یا توابع، می تواند همچنین آن بسیار کمتر قابل خواندن می کند. 

تورفتگی دیگری مهم است بعد از فرمت کد. همیشه، همیشه، همیشه دندانه دار کردن بدن از یک تابع، حلقه، یا بیماری است. این روشن می سازد که خط از کد در داخل حلقه، به عنوان مثال، که خطوط کد خارج از آن هستند. CS50 توصیه می کند که شما با چهار فضاهای دندانه دار کردن، اما اگر شما چیز دیگری را انتخاب کنید، مطمئن شوید که سازگار باشد در طول نمایید. در آن توجه داشته باشید، CS50 توصیه می کند که شما به جای پرانتز خط خود را. به این ترتیب، پرانتز صف بصری در سمت چپ حاشیه، به طوری که آن را شفاف و که در آن یک بلوک آغاز می شود و به پایان می رسد روشن است. با این حال، آن را نیز درست به جای پرانتز در همان خط به عنوان یک شرایط، برای مثال، به منظور حفظ فضا. اگر شما این کار، هر چند، مطمئن شوید که شما شامل یک فضای قبل از بریس فرفری پس از آن smooshed در کنار بسته شدن نیست پرانتز یا یک کلمه. 

هر کدام را انتخاب می کنید، مهم ترین چیز این است که تمام کد شما سازگار است. چه ما نمی خواهیم برای دیدن، هر چند، فاصله دار آکولاد. انجام این کار باعث می شود پرانتز به نظر می رسد از قطع شرط، حلقه، یا تابع آنها demarcating، ساخت کد سخت به خواندن. در C و زبان های دیگر خواهیم دید، آکولاد اختیاری برای شرایط خط و یا حلقه. این خوب است برای حذف آکولاد در این مورد، اما اگر شما با انجام این کار، مطمئن شوید که سازگار باشد در طول نمایید. 

هنگام تعریف توابع، CS50 توصیه بنویسید نوع تابع را بر روی همان خط به عنوان نام بازگشت تابع. با این حال، آن را نیز OK به نوشتن نوع بازگشت خود را در آن خط، که می تواند تعاریف تابع آسان تر برای پیدا کردن بعضی از ویرایشگرهای متنی. 

در آخر، مطمئن شوید که شامل فضا های اطراف کلمات کلیدی و اپراتورها. به عنوان مثال، یک خط که می گوید نوع int x = 5 بسیار آسان تر به خوانده شده اگر فضای اطراف علامت مساوی وجود دارد. به طور مشابه، اطمینان حاصل کنید که یک فضای پس از کلمات کلیدی می خواهم اگر، ، و در حالی که. بدون فضا، این می تواند مانند فراخوانی تابع، که آنها نیستند. 

پس اجازه دهید نگاهی به عنوان مثال استفاده از سبک خوب به بد فرمت شده از یک بلوک کد است. خوب، اجازه دهید شروع از بالا. ما می توانید ببینید که باز کردن بریس اصلی بر روی همان خط به عنوان نام تابع است. اگر ما قصد داریم برای انجام این کار، باید وجود داشته باشد فضای بین پرانتز بسته شدن و تحریک احساسات، مثل این. با این حال، CS50 توصیه می کند که پرانتز ایستاده خط خود را. بنابراین انجام این کار اجازه دهید. حالا که ما در بدن از تابع اصلی هستیم، ما باید برای شروع به ایجاد تورفتگی متن، کد، خواهیم استفاده توصیه می شود چهار فضاهای. بعد، ما می بینیم که هیچ فاصله ای وجود دارد در اطراف علامت تساوی در اینجا، به طوری اضافه کنید که به شما اجازه. در اینجا، ما می بینیم که هیچ فضای بین اگر و وجود دارد باز پرانتز، به طوری اضافه کنیم که همراه با برخی از فضای اطراف بیشتر از نشانه است. باز هم، ما می بینیم هیچ فضای بین پرانتز بسته شدن و وجود دارد بریس باز در اینجا. اگر ما در حال رفتن به قرار دادن آنها در همان خط، نیاز به وجود دارد فضای قبل از بریس فرفری. با این حال، آن را مانند بدن ما به نظر می رسد تنها شرط یک خط است. بنابراین ما نیازی به پرانتز در همه. ما در حال حاضر نیاز به مطمئن شوید که متن را در بدن هر یک از شرایط ما. ما قطعا نمی خواهید این خط آخر به همان ضربه خط به عنوان دیگری، بنابراین اجازه دهید را وارد کنید و دندانه دار کردن. در نهایت، بستن زانوبند فرفری برای نیازهای اصلی بر روی خط خود را دارد. 

ما در اینجا می توانید ببینید که ما داریم دو بلوک از کد مربوط به. خطوط 4 تا 6 بی درنگ به کاربر برای ورودی و خط باقیمانده صفحه نمایش است که ورودی را به کاربر می دهد. بنابراین آن را حس می کند برای قرار دادن برخی از فضای بین این دو بلوک برای وضوح. و در آنجا ما بروید، در حال حاضر این کد بسیار آسان تر برای خوانده شده سبک خوب است. 

در نهایت، اجازه دهید بحث در مورد جزء سوم خود را از سبک خوب: متغیر نام. نام متغیر شما باید توصیف ارزش است که آنها را نمایندگی کند. بیایید دوباره به مثال قبل ما. بطری یک نام توصیفی برای متغیر این است که نشان دهنده که چگونه بسیاری از بطری های روی دیوار باقی مانده است. اسامی مثل X یا numBots بسیار توصیفی نیست و برای خوانایی کد شما خوب نیست. در حالی که متغیر به نام نامه مشترک در ریاضی و زمینه های دیگر، آنها می توانند کد خود را بسیار سخت به درک. استثنا برای این قاعده تکرارکننده است متغیرهای داخل حلقه است. در حلقه، به عنوان مثال، آن را خوب به استفاده از متغیر نام مثل من، J و K برای تکرار. هنگام ایجاد متغیر های تکرارکننده در حلقه، توصیه می شود که شما این کار را در حلقه خود، و نه از خارج از حلقه، به طوری که ما می توانیم نگه داشتن متغیر به عنوان محکم scoped به عنوان امکان پذیر است. 

در سوی دیگر، تعدادی از نام متغیر مانند بطری سمت چپ بر روی دیوار است، در حالی که توصیفی، بیش از حد دراز و لازم نیست. در صورت شما نمی خواهید برای ایجاد یک متغیر با کلمات چندگانه، جدا کردن این کلمات با تأکید است. به عنوان مثال، is_ready بسیار خوانا تر از isReady. این خوب است به اعلام متغیرهای متعدد بر روی همان خط است. با این حال، اگر شما این کار را، انجام برخی از متغیرهای مقداردهی اولیه نیست، بلکه دیگران نیست. این بدان معناست که چیزی شبیه به dimes هوشمند، سکه نقطه و ویرگول بدین شکل؛، خوب است. اما اعضای هیات dimes = 0، سکه نقطه و ویرگول بدین شکل نمی باشد. 

در نهایت، هنگامی که اشاره گر اعلام، آن را توصیه می شود که شما با قرار دادن ستاره بعدی به نوع اشاره گر، نام متغیر است. بنابراین اعضای هیات * P است و نه از بین المللی توصیه می شود فضای * P. Whoo! به طوری که به نظر می رسد مانند بسیاری از قوانین به به یاد داشته باشید، اما نگران نباشید. اگر تا کنون در شک، دریغ نکنید با اشاره به CS50 راهنمای سبک آنلاین. 

اجازه دهید به سرعت خلاصه مهم نقاط سبک کد. اول، نظر کد شما. همیشه، همیشه، همیشه آن چیزی توابع توصیف با نظر چند خط و اظهار نظر هر چند خط کد را در خط. دوم. سازگار با قالب بندی کد های خود استفاده کنید. توجه به قرار دادن و استفاده از پرانتز و همچنین به عنوان فاصله در اطراف کلمات کلیدی و اپراتورها. در نهایت، انتخاب نام توصیفی متغیر است. متغیرها باید ارزش آنها نشان دهنده، توصیف، اما باید شما را برای همیشه به نوع. 

و آن است. همه از این به سرعت به طبیعت دوم شما تبدیل نوشتن کد بیشتر و بیشتر است، و به شما امکان برنامه نویسی با سبک در هیچ زمان. نام تامی است، و این CS50.