Ciao e bentornato.
Stiamo iniziando una nuova sezione.
E in questa sezione, voglio parlare di alcuni dei concetti di base in C.
Voglio descrivere alcune delle cose che abbiamo avuto nel nostro esempio o la nostra prima sfida, il
nostro programma principale qui.
Quindi ho questa sfida, probabilmente te la ricordi.
Ha un numero di istruzioni diverse in righe di codice.
Cercherò di coprire alcuni dei concetti qui. Vado avanti e indietro su questo esempio.
La prima cosa di cui voglio discutere è il concetto di commento.
Quindi torneremo su questo in un secondo. A questo punto voglio passare ad alcune diapositive.
Quindi i commenti vengono utilizzati in un programma per documentare un programma
e migliorarne la leggibilità.
Ti ho detto perché è importante che il tuo programma sia leggibile.
Perché manterrai il codice e devi essere in grado di guardarlo e
capire cosa sta facendo. Quindi, con i commenti,
può aiutare un
po 'in questo concetto di leggibilità.
I commenti sono lì per ricordare a te oa qualcun altro che sta leggendo
il tuo codice cosa sta facendo il programma o cosa sta facendo una particolare riga di codice.
Quindi i commenti sono lì a tuo vantaggio.
I commenti vengono ignorati dal compilatore.
Quindi non importa se segui la sintassi dei commenti, il compilatore non
genererà errori, qualunque cosa sia all'interno del commento.
Quindi, di nuovo, sono molto utili e vuoi usarli nei tuoi programmi.
E sono un concetto di base di tutti i linguaggi di programmazione.
E quindi non c'è davvero niente di nuovo da vedere qui.
Di nuovo, potresti, come programmatore, scrivere del codice, tornarci in 6 mesi
e potresti non ricordare perché hai
scritto il codice nel modo in cui l'hai fatto.
Potresti non capire la funzionalità, potresti non capire la logica.
Fornendo un commento nel codice, è
possibile risparmiare una notevole quantità di tempo che si spreca per riapprendere le cose,
in particolare per riapprendere quel codice.
Oppure immagina di aver scritto del codice
ed è un programma di grandi dimensioni, ci sono molti programmatori che ci lavorano
e qualcun altro ha bisogno di guardare quel codice.
Se ci sono commenti e stanno descrivendo cosa sta facendo il codice, allora
l'altra persona sarà in grado di capire quel codice molto più velocemente.
Sarà più leggibile. Quindi, ancora una volta, i commenti aiutano
la leggibilità o aiutano la leggibilità del programmatore che ha scritto il codice o
aiutano la leggibilità di qualcun altro che sta guardando il codice.
Puoi facilmente guardare quel codice sorgente e quindi capire rapidamente cosa sta facendo il codice.
Quindi vuoi fornire commenti nel tuo codice.
La sintassi per fornire commenti nel codice è
che esistono 2 modi per fornire commenti nel codice.
E ancora, questo è molto, molto simile a java, molto simile a molte lingue.
Ma in c, puoi avere commenti su più righe o commenti singoli.
Se usi 2 caratteri la barra in avanti seguita dall'asterisco, questo
significherà un commento su più righe, un commento che
si estende su molte righe.
E la stella con la barra in avanti segna l'inizio di quel commento.
E quando hai questi commenti su più righe perché hanno un commento
iniziale, devi avere qualcosa che dica che sta finendo.
Quindi, per terminare i commenti, inserisci i caratteri asterisco
barra alla fine senza spazi intermedi.
E quindi tutto ciò che si trova tra la stella
con barra in avanti e la stella finale con
barra in avanti è considerato
un commento, tutto in blu. E in questo modo puoi estendere più righe.
L'altro modo in cui puoi aggiungere un commento al tuo programma c è che puoi usare commenti
su una sola riga.
I commenti su una sola riga sono solo 2 barre in avanti.
Qualsiasi cosa dopo le 2 barre in avanti su quella riga
viene ignorata dal compilatore e considerata un commento.
Qualunque cosa dopo non è un commento, è una nuova riga di codice.
Quindi dipende davvero dal commento
che fornisci se desideri o meno utilizzare commenti su più righe o commenti su una sola riga.
E ti mostrerò come puoi aggiungerli al tuo codice in un secondo.
Ora, per quanto riguarda lo stile, indipendentemente dal fatto che utilizzi commenti su più righe o
commenti su una riga, probabilmente li utilizzerai entrambi a seconda di ciò che stai cercando di fare
o di quante righe devi descrivere o quanto è grande il tuo commento.
In questo esempio, stiamo usando un commento su più righe qui, e
questo normalmente andrebbe all'inizio del file. Descrive chi ha scritto
il file, l'autore del file e quindi un copyright.
Puoi anche fornire commenti che risaltano se qualcosa di
veramente molto importante nel tuo codice sta
accadendo fornendo molti asterischi.
E quindi il secondo esempio qui in cui si dice che questo è un commento
molto importante si distingue davvero per tutti quegli asterischi.
Quindi è una specie di stile diverso rispetto al commento di intestazione in
alto nel primo esempio.
Ora l'ultimo esempio qui che è solo un commento a riga singola, è
alla fine di una riga di codice e fondamentalmente ti dice solo cosa sta facendo una singola riga.
Quindi vedi questi diversi stili di commenti su più righe rispetto a quelli a riga singola.
Ecco un esempio comune che vedresti in un programma.
Questo è un programma che contiene codice C.
Probabilmente non sai davvero cosa diavolo sta facendo.
Ma potresti guardare i commenti e identificare cosa sta succedendo.
Quindi c'è un commento in alto che dice che questo programma aggiunge 2 valori interi e visualizza i risultati.
Ti sta dicendo lo scopo del programma,
cosa sta facendo.
E poi vedi alcuni commenti su una sola riga.
E come fai a sapere che sono commenti su una riga? Perché hanno 2 barre in avanti.
Quindi vedi un commento a riga singola che dice la dichiarazione delle variabili.
Ne vedi un altro che dice assegnare valori e calcolare la loro somma.
E poi ne vedi uno che dice mostra il risultato.
Ogni singola riga di commento descrive ogni singolo gruppo di codice, dicendoti cosa
stanno facendo.
E così puoi guardare rapidamente questo
codice e capire cosa sta facendo il codice guardando i commenti.
Rende il programma più leggibile.
La leggibilità è un vantaggio perché rende il codice più facile da mantenere.
Quindi è importante utilizzare i commenti. E questo è un rapido esempio di
aggiunta di commenti a un codice.
Ora, quanto spesso dovremmo utilizzare i commenti.
C'è il concetto di avere troppi commenti.
Non vuoi che il tuo codice abbia un commento per ogni singola riga.
Ciò riduce effettivamente la leggibilità del codice perché è solo traboccante.
In realtà sta rendendo più difficile la lettura perché è semplicemente travolgente.
Quindi non vuoi mettere un commento per ogni singola riga di codice.
Devi scegliere i tuoi commenti con saggezza e usarli in modo intelligente.
Questo verrà con la pratica, quando
aggiungere commenti, quando non aggiungere commenti, dove metterli.
In genere, avrò commenti nella parte superiore del mio file
sorgente con informazioni standard come l'autore, lo scopo, la descrizione, la data
di creazione dei commenti, quindi intervallati in tutto il mio codice, descrivendo alcune
righe di codice dove si trova la logica un po 'più complicato.
Non includerò sempre commenti solo per dichiarare variabili perché è abbastanza ovvio.
Potrei non includere commenti per determinate funzioni, descrizioni perché
la descrizione stessa potrebbe essere più significativa.
Tutto dipende e arriva con la pratica.
Ma ogni volta che aggiungi commenti, è tradizionalmente una buona idea
aggiungere quei commenti quando scrivi il codice.
Uno perché se lo fai allora, avrai il programma commentato e non
ti dimenticherai di farlo.
È anche più facile documentare al programma perché si
capisce effettivamente cosa sta facendo mentre si scrive il codice.
Ancora fresco nella tua mente, non devi tornare un mese
dopo e dire cosa volevo dire qui e ora devo aggiungere un commento.
Quindi aggiungi i commenti mentre scrivi il codice.
E i commenti possono anche aiutare quando stai cercando di trovare e correggere i tuoi
errori, durante la fase di debug. Se ci sono errori logici,
puoi guardare i commenti e puoi isolarli, beh, questo è
l'errore che si è verificato.
Questo tipo di commento è in linea con quella funzionalità.
Scommetto che l'errore è in questo gruppo di codice. Quindi ti aiuta a isolare gli errori nel debug.
Un commento può aiutarti a leggere il programma, ma può anche indicare la strada all'origine
di un errore logico, quindi i commenti sono importanti.
Ora, l'altro argomento quando si forniscono commenti è
che c'è di nuovo questo grande dibattito con i programmatori, quanti commenti fornite?
E c'è un bel libro là fuori chiamato Clean Code, che parla della
scrittura di codice di qualità. Che ci crediate o no,
può esserci un codice buono o un codice cattivo, e questo
è indicato come la qualità del codice.
Vuoi scrivere codice di alta qualità.
Ne parleremo durante il corso, ma molti studenti che imparano nuove lingue pensano finché l'output corrisponde a
ciò di cui ho bisogno, non importa
come scrivo il codice. Non è vero.
Perché ancora una volta, ricorda quella fase di manutenzione.
Ricorda che il prodotto o
il programma che rilasci uscirà sul campo forse per un certo numero di anni.
Quindi, se vuoi trovare bug esistenti o aggiungere nuove funzionalità, è importante
che il codice sia di altissima qualità, più facile da mantenere, molto
debolmente accoppiato, altamente coeso.
E parleremo di questi concetti man mano che procediamo.
Scriveremo codice di alta qualità per tutta la classe.
Uno dei modi per scrivere codice di alta qualità è fornire commenti
ma anche commenti auto-documentati.
Ciò significa che utilizza davvero nomi significativi. Questo è ciò di cui parla il libro Clean Code.
Quando crei una variabile, usa un nome significativo.
Quindi, quando guardi la variabile, sai esattamente per cosa viene utilizzata, quindi non
è necessario fornire un commento.
Se hai una funzione che aggiunge 2 numeri, assegna un nome alla funzione aggiungi 2 numeri.
Allora hai bisogno di un commento per dire cosa sta facendo quella funzione, no.
Perché il nome ti dice cosa sta facendo.
Quindi i nomi significativi sono un buon modo per fornire commenti auto-documentati.
Torniamo al nostro esempio dalla nostra sfida
e voglio mostrarti esattamente come
puoi aggiungere commenti e dove li aggiungi.
E noterai che il compilatore ignorerà questi commenti.
Quindi nel nostro primo esempio qui che è un programma
di base, in genere aggiungerò commenti su più righe all'inizio del file prima di qualsiasi riga di codice.
E ricorda che possiamo aggiungere quei commenti su più righe fornendo semplicemente una barra, una stella,
un asterisco per iniziare il commento.
E poi qualsiasi cosa tra il
commento sarà il
commento, qualsiasi cosa tra la stella e l'asterisco.
E noterai quando eseguo quella stella obliqua che tutto è grigio perché questo
mi dice che non ho il mio commento finale in questo momento.
Quindi devi aggiungere quella barra in
avanti per terminare il commento. E vedrai che i colori ora cambiano.
Questo è il motivo per cui mi piace usare un IDE perché ti dice molto con questa formattazione coordinata
a colori.
Quindi qualsiasi cosa tra la barra a stella è l'inizio di un
commento su più righe, qualsiasi cosa prima della stella in avanti è la
descrizione o la fine del commento su più righe.
E di solito metto in cima al file
qualcosa come autore e metto il mio nome e poi metto forse uno scopo.
Di solito è una buona pratica e inserirò qualcosa di simile a
questo programma, stampando il mio nome sullo schermo.
E poi di solito fornisco una data di quando è stato creato qualunque sia la data.
E questo è un esempio di commento su più righe in alto. E poi fornirò commenti in
tutto il codice. Di solito commenti su una
riga o commenti su più righe, dipende solo da quanti commenti ci sono.
Quindi forse non abbiamo familiarità con questo codice. E potrei dire che sai che 2
barre in avanti sono un commento di una sola riga. Posso dire che questo codice
mostra il mio nome.
E ancora, quando fornisco queste barre o questi commenti su
più righe, il compilatore li ignora. Fondamentalmente, puoi mettere tutto quello che vuoi lì dentro e non importa.
Non c'è sintassi che devi seguire, non c'è niente.
Ignorare tutto ciò che è colorato di grigio qui, è
considerato un commento.
Quindi i commenti sono una cosa fondamentale fondamentale di ogni programma.
Volevo descriverli all'inizio perché li userò e dovresti aggiungerli
mentre scrivi il tuo codice.
Inoltre, con i commenti all'interno dell'IDE, ci
sono momenti in cui stai compilando il tuo codice e tutto fallisce.
E quindi ci sono momenti in cui potresti voler commentare tutto o commentare blocchi di
codice per provare a eseguire il debug del tuo problema, prova a isolare il tuo errore.
Puoi evidenziare più righe di codice e poi andare
alla modifica nel menu e puoi dire commento o
rimuovere il commento.
Se dici commento, commenterà tutto il codice che
hai evidenziato.
E poi puoi ricompilare e forse non hai più un errore del compilatore.
È un modo per isolare gli errori in fase di runtime o in fase di compilazione.
Quindi l'IDE ha alcuni strumenti
carini che ti consentono di commentare più righe automaticamente evidenziandole
e alternandole.