[Powered by Google Translate] Në këtë video, ne do të diskutuar kodin stil, e cila është diçka
që është afër dhe i dashur në zemrën time.
Stili përshkruan se si kodi juaj është formatuar, e cila është
pavarur nga ajo që kodi të vërtetë e bën.
Jo vetëm që do të merrni ju stil të mirë të një grade më të mirë në CS50,
por ajo gjithashtu do të ju ndihmojë të shkruani kodin që është shumë më
lexueshëm dhe maintainable, e cila, në fund të ditës,
do të bëjë jetën tuaj shumë më të lehtë.
>> Të tre komponente kryesore të stilit të kodit që ne do të diskutuar
kjo video janë komente, formatimi,
dhe emrat e ndryshueshme.
Le të fillojmë me komente.
Mos harroni, komentet kanë asnjë efekt mbi
funksionalitetin e kodit tuaj.
Ata vetëm shërbejnë si lë të kuptohet e dobishme për ne si programuesit.
Komentet më të mirë duhet të përgjigjem një nga dy pyetjet.
>> Së pari, çfarë e bën këtë bllok i kodit të bëni?
Ky është një përshkrim i shkurtër dhe e ëmbël e me qëllim të
linjat që ndjekin.
Për shembull, ju mund të kenë nevojë për të gjetur vendin ku ju
zbatuar një funksion të veçantë për të rregulluar një
bug apo diçka ndryshim.
Pa komente, ju mund të kenë nevojë për të pore mbi linjat e shumta të
Kodi u përpjekur të kuptoj se saktësisht se ku karakteristikë është.
Ose në qoftë se ka qenë disa ditë që ju keni shikuar në një nga
programet tuaja, ju nuk mund të mbani mend se çfarë një të veçantë
funksioni ose loop bën.
Kështu do të bëjë komente reacquainting veten me
Kodi i vjetër, ose acquainting veten me dikë tjetër është
Kodi, shumë smoother.
Pyetja e dytë një përgjigje të mirë Komenti është arsyeja pse nuk kam
zbatojë këtë bllok në këtë mënyrë?
Si ju shkruani kodin, ju do të shpesh duhet
për të marrë vendime të projektimit.
Duhet të përdorni një lak, ndërsa për ose një lak këtu?
Duhet ta bëjnë këtë bllok i kodit në një funksion të veçantë?
Përdorimi komentet, ju mund të dokumentoni dizajnit tuaj
vendime, të cilat do të bëjë kodin tuaj më të lehtë për të kuptuar
për të tjerët, të cilët mund të jenë duke kërkuar vetë të njëjtën gjë e saktë
Pyetjet e projektimit si ata lexojnë kodin tuaj.
Ose edhe veten, në qoftë se ju vijnë përsëri në një bllok të kodit pas
disa periudha kohe.
>> Në C, dhe gjuhët e tjera ne do të shohim në CS50, ka
dy mënyra për të shtuar komente për kodin tuaj, në-linjë Komentet
dhe multi-line komente.
Në-linjë Komentet janë të mëdha për dokumentimin copa të kodit
brenda funksioneve.
Për shembull, një në-linjë koment mund të përshkruajnë
Qëllimi i një për lak, ose një rast që kërkon qoshe
një kusht.
Multi-line komente janë të mëdha për dokumentimin e funksioneve.
Sa herë që ju shkruani një funksion, ju duhet gjithmonë, gjithmonë,
gjithmonë të dokumentuar atë që bën me një koment.
Kjo përfshin atë që inputet janë në funksion, çfarë
Prodhimi i funksionit është, dhe ndoshta pse funksioni
zbatohen në mënyrë që ajo është.
Kurdo që ju të ndryshojë nënshkrimin e një funksioni së, të kthehen
vlera, ose zbatimi, është e rëndësishme për të rinovuar edhe
Komenti përkatëse dokumentacionin.
Një mospërputhje në mes të një komenti të funksionojë dhe
Zbatimi mund të jetë me të vërtetë konfuze për lexuesit.
Në mënyrë të ngjashme, duke krijuar një koment multi-line në krye
e secilit. C ose. fotografi h ju shkruani, duke përshkruar se çfarë
fotografi ka, është gjithashtu një ide shumë e mirë.
>> Si ju jeni duke komentuar kodin tuaj, një nga pyetjet e para që ju
mund të ketë është, mirë, sa duhet të komentojë kodin tim?
Kjo është shpesh e panevojshme për të dokumentuar çdo
linjë të vetme të kodit.
Për shembull, një linjë që thotë int x = 5 nuk ka nevojë për një
komentojnë në lidhje me atë që thotë se "të vendosur në 5 x".
Nuk komentuar mjaft, edhe pse, siç kemi parë, mund të bëjë
kuptuar kodin tuaj shumë e vështirë.
Pra, një rregull i mirë i gishtit është që të komentojë blloqe interesante të
Kodi, ku një bllok përbëhet nga disa rreshta të lidhura.
>> Pra, le të marrin një vështrim në një shembull.
Këtu është një funksion uncommented C.
Mirë, pasi ky është një funksion, gjëja e parë që ne kemi nevojë për të shtuar
është një koment shpjeguar se çfarë inputeve funksionin e
janë dhe atë që bën.
Pra, le të shtoni një koment multi-line.
Madhe.
Tani ne e dimë saktësisht se çfarë funksioni ynë bën.
Le të shtoni disa-line në komentet tani.
Ne mund të ndajnë kodin tonë në dy blloqe të linjave të ngjashme.
Lines vargjet 4 dhe 5 të ndërtuar në bazë të inputeve dhe
Linjat e 6 nëpërmjet 9 output ato
vargjet brenda Këngë Lirike.
Pra, le të dokumentojnë se me komente.
Awesome.
Tani funksioni ynë është komentuar.
>> Vini re se komentet në-linjë tanë nuk keni nevojë të përdorni të plotë
ose fjali në fund me një periudhë.
Është e rëndësishme që ka një hapësirë ​​mes slash dytë
dhe fillimin e komentit.
Kjo është frekuenca e komenteve brenda programeve tuaja
që ju duhet për të shtënat.
Vini re këtu se si kemi ndarë dy blloqe të kodit të lidhur
brenda funksionit tonë kor me një kthim topi shtesë.
>> Kjo na sjell në komponentin tjetër të stilit kodi,
formatting.
Kur unë parë filloi programimit, unë goditi Enter
Çelësi shumë rrallë, e cila rezultoi në gjigant, i paqartë
blobs e kodit.
Unë mendoj në fakt ofenduar shokun tim të mësimdhënies, pasi ajo
nuk ishte shumë i kënaqur me mua.
Vizualisht grupim blloqet e kodit të lidhura, duke përdorur transportin
kthimit, mund të bëjë kodin tuaj më të lehtë dhe të qartë të cek
përshkruaj cilat linja të kodit komentet tuaja janë shpjeguar.
Kjo u tha, nga përhapja kodin tuaj shumë, si me
dy ose më shumë linja midis blloqeve të kodit apo funksioneve, mund të
gjithashtu të bëjë shumë më pak i lexueshëm.
>> Kubi është një tjetër e rëndësishme
Aspekti i formatit të kodit.
Gjithmonë, gjithmonë, gjithmonë porosit trupin e një funksioni, loop,
ose kusht.
Kjo e bën të qartë se cilat janë vijat e kodit brenda një
loop, për shembull, dhe të cilat rreshta të kodit
janë jashtë për këtë.
CS50 rekomandon që ju porosit me katër hapësira, por
në qoftë se ju zgjidhni diçka tjetër, të jetë e sigurtë se do të jenë në përputhje
të gjithë kodin tuaj.
Në lidhje me këtë, CS50 rekomandon që ju vendosni formatimin e teksteve
on line e tyre.
Në këtë mënyrë, formatimin e teksteve do të vijë deri vizualisht në të majtë të njëjtë
diferencë, kështu që është e qartë si kristali ku një bllok fillon dhe mbaron.
Megjithatë, është gjithashtu e mirë për vendin e formatimin e teksteve në të njëjtën linjë si një
kusht, për shembull, për të ruajtur hapësirë.
Nëse ju bëni këtë, edhe pse, sigurohuni që ju të përfshijë një hapësirë
para mbajtëse kaçurrel kështu që nuk është smooshed e ardhshme për një mbyllje
prindërve apo një fjalë.
>> Cilado që ju zgjidhni, gjëja më e rëndësishme është që të jetë
në përputhje të gjithë kodin tuaj.
Ajo që ne nuk duam të shohim, megjithatë, është
formatimin e teksteve kaçurrel prerë.
Duke bërë kështu që bën formatimin e teksteve duken të shkëputur nga
, kusht loop, ose funksioni ata po shënimin, duke e bërë
Kodi vështirë për të lexuar.
Në C dhe gjuhë të tjera ne do të shohim, formatimin e teksteve kaçurrel janë
fakultative për kushtet linjë të vetme ose unazore.
Kjo është në rregull për të heq formatimin e teksteve kaçurrel në këtë rast, por nëse
ju bëni kështu, të jetë e sigurtë se do të jenë në përputhje
të gjithë kodin tuaj.
>> Kur përcaktimin e funksioneve, CS50 rekomandon që ju shkruani
kthehen llojin e funksionit në të njëjtën linjë si emër të
funksion.
Megjithatë, është gjithashtu OK për të shkruar llojin e kthimit më vete
line, e cila mund të bëjë përkufizime funksion më të lehtë për të gjetur në
disa redaktorët tekst.
>> Së fundi, të jetë i sigurt për të përfshirë hapësirat përreth
fjalë kyçe dhe operatorët.
Për shembull, një linjë që thotë int x = 5 është shumë më e lehtë për të
lexoni nëse ka hapësira rreth shenjë të barabartë.
Në mënyrë të ngjashme, sigurohuni që ju keni një hapësirë ​​të keywords, pasi si në qoftë se,
për, dhe ndërsa.
Pa një hapësirë, këto mund të duken si thirrje funksion,
të cilat ata nuk janë.
>> Pra, le të marrin një vështrim në një shembull të aplikoni stilin e mirë
në një bllok keq formatuar të kodit.
Mirë, le të fillojë nga lart.
Ne mund të shohim se hapjen e tiranta kryesor është në të njëjtën
Shkarko si emri i funksionit të.
Nëse ne jemi duke shkuar për të bërë këtë, nuk duhet të jetë një hapësirë ​​në mes të
the prindërve dhe mbylljes shtrëngoj, si kjo.
Megjithatë, CS50 rekomandon që formatimin e teksteve të qëndrojë
on line e tyre.
Pra, le ta bëjmë këtë.
Tani që ne jemi në trupin e funksionit kryesor, ne do të duhet
për të filluar indenting kodin, ne do të përdorim
rekomanduar katër hapësira.
Tjetra, ne shohim se nuk ka hapësirë ​​rreth shenjë të barabartë
këtu, kështu që le të shtoj se.
Këtu, ne shohim se nuk ka hapësirë ​​në mes të, nëse dhe
prindërve të hapur, kështu që le të shtoj se, së bashku me një hapësirë ​​rreth
më i madh se shenjë.
Përsëri, ne shohim nuk ka asnjë hapësirë ​​midis Paren mbylljes dhe
Brace hapjes këtu.
Nëse ne jemi duke shkuar për të vënë këto në të njëjtën linjë, nuk ka nevojë për
të jetë një hapësirë ​​para mbajtëse kaçurrel.
Megjithatë, kjo duket si e trupit të tonë
Gjendja është vetëm një linjë.
Pra, ne nuk kemi nevojë për të përfshirë formatimin e teksteve në të gjitha.
Ne tani duhet të jetë i sigurt për të porosit në trupin e secilit prej
kushtet tona.
Ne definitivisht nuk dua që kjo linjë e fundit të jetë në të njëjtën
hit linjë si tjetër, kështu që le të vendosë dhe të porosit.
Së fundi, Brace mbylljes kaçurrel për nevojat kryesore të jetë në
Linja e vet.
>> Ne mund të shohim këtu kemi dy të ndryshme
blloqet e kodit të lidhura.
4 linja përmes 6 shpejtë përdorues për kontributin dhe
Linjat e mbetura të shfaqin se input të përdoruesit.
Pra, kjo ka kuptim për të vënë një hapësirë ​​në mes të këtyre dy blloqeve
për qartësi.
Dhe ne do të shkojmë atje; tani ky kod është shumë më e lehtë për të lexuar me
stil të mirë.
>> Së fundi, le të flasim për komponentin e tretë të stilit tonë të mirë:
Emrat e ndryshueshme.
Emrat tuaj ndryshueshme duhet të përshkruajë
vlera që ata përfaqësojnë.
Le sërish shembullin tonë më parë.
Shishe është një emër të mirë përshkrues për variablin që
përfaqëson sa shishe janë lënë në mur.
Emrat si x apo numBots nuk janë shumë përshkrues dhe janë
nuk është e mirë për lexueshmëri të kodit tuaj.
Ndërsa variabla quajtur nga një shkronjë të vetme janë të zakonshme në
matematikë dhe fusha të tjera, ata mund të bëjnë kodin tuaj shumë e vështirë
për t'u kuptuar.
Përjashtim nga ky rregull është iterator
variablave brenda sythe.
Në për sythe, për shembull, ajo është në rregull për të përdorur ndryshore
emrat si i, j, k dhe për përsëritje.
Kur krijimin e variablave iterator brenda sythe, kjo është
rekomanduar që ju të bëni këtë brenda lak vetë, në vend
se jashtë lak, kështu që ne mund të vazhdojmë variabla si
fort scoped të jetë e mundur.
>> Nga ana tjetër, një emër i ndryshueshëm si numri i shisheve
lënë në mur është, ndërsa përshkruese, tepër fjalëshumë
dhe nuk është e nevojshme.
Në rast ju nuk doni të krijoni një ndryshore me
Fjalët e shumta, të ndarë me këto fjalë nënvizon.
Për shembull, is_ready është shumë më i lexueshëm se isReady.
Kjo është në rregull për të deklaruar variablave të shumta në të njëjtën linjë.
Megjithatë, në qoftë se bëni kështu, nuk do të nisja disa variabla, por
jo të tjerët.
Kjo do të thotë diçka si dimes int, pennies
pikëpresje, është në rregull.
Por dimes int = 0, pennies
pikëpresje nuk është.
>> Së fundi, kur deklaruar pointers, është e rekomanduar
se ju vendosni yll tjetër për llojin treguesin nuk,
Emri i variablit.
Pra, int * p rekomandohet sesa int
Hapësira * p.
Whoo!
Kështu që duket si një shumë e rregullave të
mbani mend, por mos u bëni merak.
Nëse ndonjëherë në dyshim, mos hezitoni për t'iu referuar të CS50
udhëzues online stil.
>> Le të përmbledhim shpejt rëndësishme
pikat e stilit kodin.
Së pari, komentoni kodin tuaj.
Gjithmonë, gjithmonë, gjithmonë përshkruajnë se çfarë funksionon bëni
me një koment të multi-line dhe komentuar çdo disa rreshta të
Kodi në-linjë.
Dytë.
Jenë në përputhje me formatimin tuaj kod.
I kushtoj vëmendje të vendosjes tuaj dhe përdorimin e teksteve
si dhe ndarje rreth fjalë kyçe dhe operatorët.
Së fundi, zgjidhni emrat përshkruese ndryshueshme.
Variablat duhet të përshkruajnë vlerën që ata përfaqësojnë, por
ju nuk duhet të marrë përgjithmonë për të tipit.
>> Dhe kjo është ajo.
E gjithë kjo do të shpejt të bëhet natyrë e dytë si ju
shkruani kodin gjithnjë e më shumë, dhe ju do të kodimit
me stil në asnjë kohë.
Emri im është Tommy, dhe kjo është CS50.