[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.