...
← Curs Swift (iOS): toate lecțiile
Lecția 4 · Afișare

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ș gol
Bun venit!
Coșul tău este gol

Vezi că rezultatul conține doar textele din print. Comentariile nu ajung în program.

Exercițiul tău

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ă.
Comentariul pe mai multe linii începe cu /* și se termină cu */.

Soluția exercițiului

// Comentariu pe o linie
/*
 Comentariu
 pe mai multe linii
*/
print("Comentariile nu se afișează")
Excelent! Continuă cu lecția următoare →
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
Bine de știut

Î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
// textComentariu până la finalul liniei
/* text */Comentariu pe una sau mai multe linii
/// textComentariu de documentație, afișat de Xcode în Quick Help
main.swiftSwift
ConsolăSe încarcă...
Mediul de lucru se încarcă. Poți citi lecția între timp.
Rulează codul cu butonul de sus sau cu Ctrl + Enter / Cmd + Enter.
Parcursul tău Fundamente Swift Lecția 4 · Comentarii în Swift
Progres 0% 0 din 17
Lecția curentă 4 / 15 Afișare