Bună ziua și bun venit înapoi.
Începem o nouă secțiune în această secțiune Vreau să vorbesc despre câteva dintre conceptele de bază și să văd că
vreau să descriu câteva dintre lucrurile pe care le-am avut în exemplul nostru sau în prima noastră provocare.
Programul nostru principal de aici, așa că am această provocare sus s-ar putea să-l amintesc.
Are o serie de afirmații diferite în linii de cod.
Voi încerca să acopere câteva dintre concepte și să mă întorc la acest exemplu, primul lucru
pe care vreau să-l discutăm este conceptul unei comete.
Așa că ne vom întoarce la asta într-o clipă.
Vreau să merg la niște diapozitive în acest moment.
Deci, comentariile sunt folosite într-un program pentru a documenta un program pentru a spori lizibilitatea acestuia.
Ți-am spus de ce este important ca programul tău să poată fi citit, pentru că vei menține codul și trebuie să
te poți uita la el și să înțelegi ce face.
Deci, cu comentarii, poate ajuta destul de puțin și acest avantaj în acest concept de lizibilitate.
Comentariile sunt acolo pentru a vă reaminti sau altcineva să vă citească codul.
Ce face programul sau ce face o anumită linie de cod.
Deci, comentariile sunt acolo în beneficiul dumneavoastră.
Comentariile sunt ignorate de compilator.
Deci, nu contează dacă, dacă urmați sintaxa de comentarii, compilatorul nu
va arunca vreo eroare în interiorul virgulei.
Din nou, sunt foarte utile și doriți să le utilizați în programele dvs. și există
un concept de bază al tuturor limbilor de programare.
Și deci nu este nimic nou aici pentru a vedea.
Din nou, în calitate de programator puteți scrie un cod care să revină la el în șase luni și este posibil să nu vă amintiți de ce
ați scris codul așa cum ați făcut.
Este posibil să nu înțelegeți funcționalitatea pe care probabil că nu o înțelegeți prin furnizarea unui comentariu
în cod.
Acesta poate salva scutirea timpului Nikica de care pierdeți pe învățarea lucrurilor, în special învățând acel cod.
Sau imaginați-vă că ați scris un cod și este un program mare.
Sunt mulți programatori care lucrează la el și altcineva trebuie să se uite la codul respectiv.
Dacă există comentarii care descriu ceea ce face codul, atunci acea persoană va putea să
înțeleagă mai repede acest cod.
Va fi mai ușor de citit.
Deci, din nou, comentariile ajută la lizibilitatea.
Fie că ajută abilitatea programatorului care a scris codul, fie că ajută la citirea altcuiva,
se uită la cod.
Puteți să vă uitați cu ușurință la codul sursă și apoi să înțelegeți rapid ce face codul.
Deci, doriți să oferiți comentarii în codul dvs.
Sintaxa pentru furnizarea de comentarii în codul dvs. are două moduri în care puteți furniza comentarii în
codul dvs.
Și din nou, acest lucru este foarte asemănător cu Java.
Foarte similar cu multe limbi, dar în C puteți avea fie comentarii multiple, fie comentarii unice.
Dacă utilizați două caractere, slash-ul următor este urmat de asterisc.
Acest lucru va marca acest lucru va însemna un comentariu multi-line un comentariu care se întinde pe mai multe
linii și cele patru slash marchează începutul acestui comentariu și atunci când aveți aceste comentarii multi-line, deoarece acestea au
un comentariu de start trebuie să aveți ceva care spune se termină.
Deci, și comentariile pe care le-ați pus asterisc-ul starurilor de caractere pentru slash la sfârșit, fără spații
între ele.
Și așa, atunci orice între stea și slash-ul final este considerat un comic.
Totul în albastru.
Și în acest fel poți să faci mai multe linii pe cealaltă cale încât să poți adăuga un comentariu la programul tău C.
Puteți utiliza comentariile unei singure linii Comentariile unei singure linii sunt doar două lovituri înainte.
Orice după cele două linii pe acea linie este ignorat de compilator și ia în considerare să vină ceva după aceea
nu este un comentariu.
O nouă linie de cod.
Deci, într-adevăr, depinde de comentariul pe care îl furnizați dacă doriți sau nu să utilizați comentarii multiple sau
comentarii de o singură linie.
Și vreau să vă arăt cum le puteți adăuga la codul dvs. într-o secundă.
Acum, în ceea ce privește stilul, dacă folosiți comentarii multiple sau comentarii de o singură linie, probabil că veți folosi ambele în
funcție de ceea ce încercați să faceți sau de câte linii trebuie să descrieți sau
cât de mari sunt comune.
În acest exemplu, folosim o virgulă cu mai multe linii, iar acest lucru se va întâmpla în partea de sus a fișierului.
Descrie cine a scris fișierul autorul fișierului și apoi un drept de autor.
Puteți oferi, de asemenea, comentarii care se remarcă dacă ceva cu adevărat important în codul dvs. se întâmplă
prin furnizarea multor asteriscuri.
Și așa, al doilea exemplu aici spune că acesta este un comentariu foarte important.
Se distinge într-adevăr din cauza tuturor asteriscurilor.
Este un fel de stil diferit de cel pe care îl aveau în comun în partea de sus și în primul exemplu.
Acum ultimul exemplu care este doar un singur comentariu.
Este la sfârșitul unei linii de cod și în principiu doar vă spune unde se face o singură linie.
Deci, vedeți aceste diferențe de stil de comentarii multi-line versus linii unice.
Iată un exemplu obișnuit pe care l-ați vedea într-un program care se numește codul progun octan C.
Probabil că nu știi cu adevărat ce naiba face asta, dar ai putea să te uiți la
comentariile și să identifici ce se întâmplă.
Deci, este comună în partea de sus care spune că acest program adaugă la oricare dintre valorile dvs. și afișează rezultatele.
Îți spune ce scop are programul.
Și apoi vedeți niște comentarii cu o singură linie și cum știți că acestea sunt comentarii de o
singură linie, deoarece trebuie să forțeze tăieturi.
Deci, vedeți dacă o singură coloană spune că declarați variabilele vedeți altul care spune că atribuie valori și calculează
suma lor și apoi vedeți unul care spune că afișează rezultatul.
Fiecare virgul de o singură linie descrie fiecare grup.
Grupuri unice de cod care vă spun ce fac.
Și astfel puteți să vă uitați rapid la acest cod și să înțelegeți ce face codul, analizând comentariile pe care
le face programul mai ușor de citit.
Lizibilitatea este un avantaj deoarece face ca codul să fie mai ușor de întreținut.
În regulă, este important să utilizați comentariile și acesta este un exemplu rapid de adăugare de comentarii la un anumit cod.
Acum cât de des ar trebui să folosim comentarii.
Există conceptul de a avea prea multe comentarii.
Nu doriți să aveți codul dvs. care are o linie de comentariu pentru fiecare linie care scade de fapt lizibilitatea
codului, deoarece este tocmai în plină expunere, fapt care face din ce în ce mai greu să citești pentru
că este doar copleșitoare.
Deci, nu doriți să puneți un comentariu în fiecare linie de cod, trebuie să alegeți
cu atenție comentariile dvs. și să le folosiți inteligent.
Deci, de obicei, este bine și acest lucru va veni cu practica atunci când să adăugați comentarii atunci când nu pentru a adăuga comentarii
în cazul în care pentru a pune comentariile.
În mod normal, voi avea comentarii în partea de sus a fișierului meu sursă cu informații standard precum autorul
Scopul descrierea, ziua creată de comentariile care au fost intercalate în codul meu, care descriu câteva linii
de cod în care logica este puțin mai complicată.
Nu voi testa acest lucru din punct de vedere tehnic sau nu voi include întotdeauna comentarii pentru a declara doar variabile,
deoarece este un fel evident.
Nu pot include comentarii pentru anumite descrieri de funcții, deoarece scrierea în sine ar putea fi
mai semnificativă.
Totul depinde și vine cu practica, dar ori de câte ori adăugați comentarii este în mod tradițional
o idee bună să adăugați acele comentarii atunci când scrieți codul unu, pentru că dacă faceți acest lucru atunci aveți
programul comentat și veți uita să îl faceți.
Este, de asemenea, mai ușor să documentați programul de ce înțelegeți de fapt ce face în timp ce scrieți codul încă proaspăt în mintea dvs.
nu trebuie să vă întoarceți o lună mai târziu și să spuneți Ce am vrut să spun aici
și de ce este un comentariu .
Așadar, am avut comentariile de ce scrieți codul și comentariile pot ajuta, de asemenea, atunci când încercați să
găsiți și să remediați erorile în timpul fazei de depanare.
Dacă există erori logice, puteți să vă uitați la comentarii și puteți să le izolați.
Ei bine, acesta este anul în care s-au întâmplat aceste tipuri de benzi desenate cu această funcționalitate.
Am betcha eroarea este în acest grup de cod, astfel încât modul în care puteți izola erorile în depanarea unui comic vă poate ajuta să citiți
prin intermediul programului, dar poate indica, de asemenea, calea spre sursa unei greșeli logice, astfel încât comentariile
sunt importante.
Acum, celălalt argument atunci când oferiți comentarii este din nou acolo această dezbatere mare cu programatori
cât de multe comentarii oferiți.
Și există o carte frumoasă acolo, numită cod curat, care vorbește despre scrierea codului de calitate.
Credeți sau nu codul poate fi un cod bun sau poate exista un cod bun sau un cod rău și
acest lucru este denumit calitatea codului pe care doriți să scrieți codul de înaltă calitate.
Vom vorbi despre acest lucru de-a lungul cursului, dar o mulțime de studenți care învață noi limbi cred că atâta timp cât
ieșirea se potrivește cu ceea ce am nevoie.
Nu contează cum scriu codul.
Nu este adevărat, deoarece amintesc din nou de faza de întreținere.
Amintiți-vă că produsul sau programul pe care îl lansați va fi în
câmp, poate pentru câțiva ani.
Deci, dacă doriți să găsiți noi dacă doriți să găsiți bug-uri existente sau să adăugați noi caracteristici, este important ca codul
să fie foarte ridicat.
De înaltă calitate ușor de întreținut foarte slab cuplat foarte coerente și toate vorbesc despre aceste concepte
ca vom trece prin noi vom fi scris cod de înaltă calitate în întreaga clasă.
Una dintre modalitățile de a scrie cod de înaltă calitate este furnizarea de comentarii, dar și furnizarea de
comentarii autocumentare.
Ce înseamnă acest lucru este folosirea cu adevărat a unor nume semnificative.
Despre asta vorbește acea carte despre cărți.
Când creați o variabilă utilizând un nume semnificativ, atunci când vă uitați la o variabilă, știți exact
ce este folosit.
Apoi nu este necesar să furnizați o virgulă.
Dacă aveți o funcție și adăugați numelui funcția adăugați două numere atunci aveți nevoie de un comentariu pentru a
spune ce face această funcție.
Nu, pentru că numele îți spune ce face.
Astfel de nume semnificative reprezintă o modalitate bună de a oferi comentarii autocumentante.
Să ne întoarcem la exemplul nostru din provocarea noastră și să vă arătăm cum vreau să vă arăt exact cum puteți adăuga
comentarii și de unde le adăugați.
Și veți observa că compilatorul va ignora aceste comentarii.
Deci, în primul nostru exemplu, care este un program de bază, voi adăuga în mod obișnuit comentarii
în mai multe rânduri în partea de sus a fișierului înainte de orice linii de
cod și amintiți-vă că putem adăuga acele comentarii cu mai multe linii, oferind doar o stea asterisc pentru a începe comentariul și apoi
orice între coloana acesta va fi comentariu.
Orice între stea și asterisc.
Și veți observa când voi face acea stea, că totul este minunat, pentru că asta
îmi spune că nu am ultimul meu comentariu, așa că trebuie să adăugați acea stea pentru Slash pentru a termina virgula și veți
vedea că culorile se schimbă acum.
Acesta este motivul pentru care îmi place să folosesc un ID, pentru că vă spune foarte mult cu această formatare coordonată de culoare,
astfel încât orice între stelele slash este începutul unui comentariu cu mai multe linii.
Orice în înainte de Star Fort este descrierea sau sfârșitul comentariului multiline și de obicei aș pune ceva în partea
de sus a fișierului.
Autor.
Nu-mi puneți numele și apoi voi pune un scop.
Știți că aceasta este de obicei o bună practică și voi pune ceva de genul acestui program îmi tipărește numele pe ecran
și apoi vă voi oferi o dată când a fost creată.
Știți ce este data și este un exemplu de comentariu de la Matalon de sus și apoi vă voi oferi comentarii în
întregul cod.
De obicei, există comentarii la o singură linie sau comentarii cu mai multe linii.
Depinde doar cât de multe comentarii există.
Deci, poate că nu suntem familiarizați cu acest cod și aș putea spune că știți două slash-uri înainte
ca un singur comentariu de linie și pot spune că acest cod este afișarea
de bani și din nou atunci când am furniza aceste patru tăieturi sau aceste comentarii pe mai multe linii compilatorul ignoră lor.
Practic poți pune tot ce vrei acolo și nu contează.
Nu există o sintaxă pe care trebuie să o urmați.
Acolo nu este nimic.
Este ignorant tot ceea ce este colorat gri aici, care este considerat un comentariu, astfel încât comentariile sunt un element fundamental de
bază al fiecărui program.
Voiam să le descriu mai devreme pentru că le voi folosi și ar trebui să le adăugați pe măsură
ce scrieți codul.
De asemenea, cu comentariile din ID, există momente când știi că compilați codul Capote și că
tot nu reușiți.
Și deci există momente când doriți să comentați totul sau să comentați blocuri de cod.
Încercați să depanați problema dvs. încercați să vă izolați.
Puteți să evidențiați mai multe linii de cod și apoi să mergeți la editarea din meniu și să puteți spune comentariu sau
să vă dezactivați dacă spuneți că comentariul va comenta tot codul.
Ați evidențiat și apoi puteți recompila și poate că nu mai aveți un compilator.
Este o modalitate de a izola erorile fie în timpul rulării, fie în timpul de compilare, astfel încât ID-ul să aibă niște instrumente
drăguțe care vă permit să comentați mai multe linii automat prin evidențierea și comutarea.