Comentarii în Swift
Un comentariu este un text din cod pe care compilatorul îl ignoră complet. Îl scrii pentru oameni: pentru colegii tăi și pentru tine peste câteva luni. În această lecție înveți cele trei feluri de comentarii din Swift și cum scrii comentarii care chiar ajută.
Comentariul pe o linie: //
Tot ce urmează după // până la finalul liniei este comentariu. Poate sta pe o linie separată sau după o instrucțiune:
// Afișăm mesajul de bun venit
print("Bun venit!")
print("Coșul tău este gol") // mesaj pentru coș golBun venit! Coșul tău este gol
Vezi că rezultatul conține doar textele din print. Comentariile nu ajung în program.
Scrie un program care conține un comentariu pe o linie (//) și un comentariu pe mai multe linii (/* */) și afișează Comentariile nu se afișează.
- Adaugă un comentariu cu //.
- Adaugă un comentariu pe cel puțin două linii cu /* și */.
- Afișează textul Comentariile nu se afișează.
Soluția exercițiului
// Comentariu pe o linie
/*
Comentariu
pe mai multe linii
*/
print("Comentariile nu se afișează") Vrei să afli mai mult?Comentariul pe mai multe linii: /* */ · Comentarii de documentație: /// · Comentarii utile și comentarii inutile · Greșeli frecvente · Rezumat
Comentariul pe mai multe linii: /* */
Când ai mai mult de spus, folosești /* la început și */ la final. Totul dintre ele este comentariu, oricâte linii ar avea:
/*
Aplicația Notițe
Autor: echipa iOS
Afișează un mesaj de test
*/
print("Test reușit")Test reușit
În Swift, comentariile /* */ pot fi puse unul în altul (/* exterior /* interior */ exterior */). În multe alte limbaje, cum ar fi C sau Java, asta dă eroare.
Comentarii de documentație: ///
Trei bare /// marchează un comentariu de documentație. Îl pui deasupra unui element din cod pentru a explica ce face. În Xcode, când ții apăsat Option și dai clic pe acel element, apare explicația ta într-o fereastră numită Quick Help.
/// Mesajul afișat pe primul ecran al aplicației. let mesajStart = "Salut!" print(mesajStart)
Salut!
Aici let creează o constantă, o valoare cu nume; o vei învăța în detaliu în lecția 7. Vei folosi /// mai ales la funcții și tipuri, pe care le înveți mai târziu. Deocamdată reține că există și că Xcode le transformă în documentație.
Comentarii utile și comentarii inutile
Un comentariu bun explică de ce faci ceva, nu repetă ce se vede deja în cod.
// Inutil: repetă codul
print("Salut") // afișează Salut
// Util: explică motivul
// Afișăm mesajul scurt pentru că ecranul ceasului este mic
print("Salut")- Scrie comentarii pentru deciziile care nu sunt evidente.
- Nu lăsa comentarii vechi care nu mai corespund codului: induc în eroare.
- Poți „opri” temporar o linie punând // în fața ei, ca să testezi ceva.
Greșeli frecvente
- Ai uitat */ la final: tot restul fișierului devine comentariu, iar compilatorul dă eroarea unterminated '/*' comment.
- Ai scris o singură bară /: nu e comentariu, compilatorul încearcă să o citească drept cod.
- Ai pus comentariul cu // în fața instrucțiunii pe aceeași linie: // print("Salut") nu mai afișează nimic.
Rezumat
| Sintaxă | Ce face |
|---|---|
| // text | Comentariu până la finalul liniei |
| /* text */ | Comentariu pe una sau mai multe linii |
| /// text | Comentariu de documentație, afișat de Xcode în Quick Help |
