[Powered by Google Translate] У овом видеу, ми ћемо разговарати стил кода, што је нешто то је близу и драги мом срцу. Стил описује како ваш код форматира, што је независно од онога што је код заправо ради. Не само да ће добар стил вас боље разред ЦС50, али ће такође помоћи да писање кода који је много више читљив и одржив, који на крају крајева, ће учинити ваш живот много лакше. 

Три главне компоненте код стила да ћемо разговарати овај видео су коментари, обликовање, и променљива имена. Почнимо са коментарима. Запамтите, коментари немају ефекат на функционалност вашег кода. Они служе само као корисне савете за нас као програмера. Добри коментари треба да одговори на један од два питања. 

Прво, шта је овај блок кода уради? Ово је кратко и слатко опис сврхе линијама које следе. На пример, можда ћете морати да пронађете место где сте спроводи одређену функцију да поправи грешку или нешто променити. Без коментара, можда ћете морати да поре преко многих линија код покушавајући да схватим тачно где је функција. Или, ако је прошло неколико дана од како си погледао на једном од Ваши програми, можда не сећате шта конкретно функција или петља ради. Дакле коментари ће учинити реацкуаинтинг себе са Стари број, или упознавање себе са туђе код, много лакшим. Друго питање добар коментар одговори зашто сам то имплементирати овај блок на овај начин? Као што пишете код, често ћете морати да доносе одлуке дизајна. Треба ли да користим ту петљу вхиле или за петљу? Да ли би овај блок кода у посебан функцију? Користећи коментарима, можете документовати свој дизајн одлуке, које ће учинити ваш код лакше разумети за друге, који могу да се питају потпуно исти дизајн питања као што су читање кода. Или чак себе, ако дођеш до блока кода, након неки период. 

У Ц, и друге језике ћемо видети у ЦС50, постоје два начина додавања коментаре кода, линијске коментари и мулти-лине коментаре. Ин-лине коментари су одлични за документовање делова кода у оквиру функције. На пример, у линији коментар би могао да опише Сврха за петље или угла случај који изискује стање. Мулти-лине коментари су одлични за документовање функције. Кад год пишете функцију, требало би да увек, увек, Увек документује оно што ради са коментаром. Ово укључује оно што улази у функцији су, шта излаз функције је, а можда и зашто је функција спроводи на начин на који је она. Кад год промените потпис неку функцију а, вратите вредност или примена, важно је да се ажурирање одговарајућа документација коментар. Несклад између коментару у функцији и имплементација може бити стварно збуњујуће за читаоце. Слично томе, стварање мулти-линијски коментар на врху сваког ц или Х датотеке пишете.., описујући шта датотека се, такође веома добра идеја. 

Као што сте коментаришући свој код, један од првих питања које можда је добро, колико треба да коментарише свој код? Често је неопходно да документују сваки једна линија кода. На пример, линија која каже инт к = 5 не треба изјасни о томе да каже "подешен на 5 к". Не коментаришући довољно, мада, као што смо видели, може да разумевање ваш код веома тешко. Дакле, добро правило је да коментарише занимљиве блокове код, где је блок се састоји од неколико повезаних линија. 

Дакле, хајде да погледамо на пример. Ево унцомментед Ц функција. Ок, пошто је ово функција, прва ствар коју треба да додате је коментар објашњавајући шта је функција за улаз и шта то ради. Дакле, хајде да додамо мулти-линијски коментар. Сјајно. Сада тачно знамо шта је наш функција ради. Хајде да додамо сада неке ин-лине коментаре. Можемо поделити наш код у два блока од по сличним линијама. Линије 4 и 5 конструисати стрингови на основу улазних и Линије 6 до 9 излаза те Жице унутар сонг лирицс. Дакле, хајде да документује да са коментарима. Страва. Сада наша функција коментарисао. 

Обратите пажњу да наши линијске коментари не треба да користе потпуно реченице или крајњих са периодом. Важно је да постоји размак између другог црте и почетак коментару. То је фреквенција коментарима унутар ваших програма да би требало да пуцају за. Приметимо како смо одвојили два блока кода повезаног унутар нашег хора функција са додатном колица повратка. 

Ово нас доводи до следећег компонента код стила, форматирање. Када сам први пут почео програм, ударио Ентер Кључ веома ретко, што је резултирало гиганта, нечитак грудвице кода. Мислим да сам стварно увредио моју асистент, јер је она није био превише задовољан са мном. Визуелно груписање сродних блокова кода, користећи превоз повратак, да би ваш код лакше да загребете и јасно описују које линије кода су ваши коментари објашњење. То што је рекао, ширећи своју шифру превише, као и са две или више линија кода између блокова или функција, може такође чине га много мање читљив. 

Увлачење је још један важан аспект код формату. Увек, увек, увек алинеја тело функције, петље, или услов. То га чини јасно које линије кода су унутра петље, на пример, и које линије кода су изван тога. ЦС50 препоручује да алинеја са четири места, али ако одаберете нешто друго, будите сигурни да буде доследна током свог кода. На тој белешци, ЦС50 препоручује да ставите заграде на својој линији. На тај начин, протезе се построје визуелно на истом леве маргина, па је кристално јасно где блок почиње и завршава. Међутим, то је такође у реду да стави протезу на истој линији као и стање, на пример, да сачува простор. Ако ово урадите, међутим, да ли сте унели размак пре коврџавом браце тако да се не смоосхед поред затварања заграда или реч. 

Који год да изаберете, најважније је да буде доследни у целом коду. Оно што не желимо да видимо, иако је Разведена витичасте заграде. На тај начин чини протеза изгледају искључени из услов, петља, или функција они Демаркацијски, чинећи код тешко прочитати. У Ц и другим језицима ћемо видети, витичасте заграде су опционо за појединачне линије услова или петљама. То је у реду да изоставите витичасте заграде у овом случају, али ако то урадите, будите сигурни да је у складу током свог кода. 

Приликом дефинисања функције, ЦС50 препоручује да упишете врати тип функције на истој линији као и име функцију. Међутим, то је такође у реду да напише тип повратка на сопствену линија, која може да функција дефиниције лакше пронаћи у неки текст едитори. 

Коначно, будите сигурни да обухватају просторе око кључне речи и оператори. На пример, линија која каже инт к = 5 је много лакше прочитајте ако постоје простори око знака једнакости. Слично томе, побрините се да имате размак после речи волео да, Јер, и док. Без простора, то би могло да изгледа функција позива, које нису. 

Дакле, хајде да погледамо на пример примене добре стил на лоше форматиран блока кода. Ок, хајде да почнемо од врха. Можемо видети да је отварање браће главних је на исти линија као име функцији је. Ако ћемо да урадимо ово, мора да постоји простор између Завршна заграда и браће, овако. Међутим, ЦС50 препоручује да стоје протезе на својој линији. Дакле, хајде да урадимо то. Сада када смо у телу функције главног ћемо морати почети Увуци код; ћемо користити Препоручује четири места. Даље, видимо да нема простора око знака једнакости овде, па хајде да додам да. Овде видимо да постоји простор између, ако и отворена заграда, па хајде да додам да је, заједно са неким простор око већи од знака. Поново видимо да нема простора између затварања и парен отварање браће овде. Ако ћемо ставити ово на истој линији, постоји потреба да се бити размака пре коврџаве браце. Међутим, изгледа да је тело нашег Услов је само један ред. Тако да не треба да се укључују протезу на све. Сада морамо да будемо сигурни да увучете у тело сваке од наши услови. Ми дефинитивно не желим да ово последња линија буде на истом линија као друго, па хајде хит Ентер и увлачење. Коначно, затварање коврџава стезник за главне потребе да буде на сопствену линију. 

Овде се види да имамо два различита блокови вези кода. Линије 4 до 6 упитати корисника за унос и Преостале линије приказују да је улаз на корисника. Тако да има смисла да се стави мало простора између ова два блока због јасноће. И тамо идемо, сада овај код је много лакше за читање са добар стил. 

Коначно, хајде да разговарамо о нашем треће компоненте доброг стила: имена променљивих. Ваша имена променљивих треба да опише вредност коју представљају. Идемо поново наш претходни пример. Боце је добар описно име за променљиву која представља колико боце су остављали на зиду. Имена попут Кс или нумБотс нису веома описно и да су није добро за читање вашег кода. Док варијабле које именује једног слова су уобичајене у математика и другим областима, они могу учинити ваш код веома тешко разумети. Изузетак од овог правила је итератор варијабли унутар петље. У петље за, на пример, добро је користити променљиву Имена попут И, Ј, К за итерацији. Приликом креирања итератор променљиве унутар петље, то је Препоручујемо да то урадите у самој петљи, а него изван петље, тако да можемо задржати варијабле као чврсто сцопед могуће. 

С друге стране, име променљиве као број боца оставили на зиду је, док је описно, претерано опширно и није неопходно. У случају да не желите да направите променљиву са више речи, одвојите оне речи са црте. На пример, ис_реади је много више него читљиве исРеади. Добро је да се изјасни више променљивих на истој линији. Међутим, ако то урадите, не покрене неке променљиве, али другима не. То значи нешто као инт Димес, пенија зарез, је ОК. Али инт центи = 0, пенија зарез није. 

Коначно, када проглашава тројки, препоручује да поставите звездицу поред типа показивач, а не име променљиве. Дакле, инт * п се препоручује уместо инт простора * п. Вау! Тако да изгледа као много правила за сећам се, али не брините. Ако икада у недоумици, не устручавајте се да се односи на ЦС50 је Онлине стил употребу. 

Идемо брзо резимирамо важна тачке код стила. Прво, коментаришу свој код. Увек, увек, увек опише шта раде функције са мулти-лајн коментара и коментаре на сваких неколико редова код у линији. Друга. Будите доследни у свом код обликовања. Обратите пажњу на свој пласман и коришћење заграда као и размаком око кључних речи и оператора. Коначно, изаберите описних имена променљивих. Променљиве треба да опише вредност они репрезентују, али Не би требало да вас заувек да куцате. 

И то је то. Све ово ће брзо постати друга природа као ти пишем више и више кода, а ви ћете бити кодирање са стилом у кратком времену. Моје име је Томи, а ово је ЦС50.