Swift izohlar

Swift izohlar

Kodni tushuntirish uchun izohlardan foydalaning.

Swift bir qatorli, ko‘p qatorli (ichma-ich joylashtirish mumkin bo‘lgan) va hujjatlashtirish izohlarini qo‘llab-quvvatlaydi.

Bir qatorli va ko‘p qatorli izohlar

Bir qatorli izohlar uchun //, ko‘p qatorli izohlar uchun esa /* ... */ dan foydalaning.

// This is a single-line comment
print("Hello")

/* This is a
   multi-line comment */
print("Swift")

/* Nested comments are allowed:
  /* inner */
*/

Ushbu misolda bir qatorli va ko‘p qatorli izohlar ko‘rsatilgan.

Hujjatlashtirish izohlari

Hujjatlar yaratish uchun e’lonlardan oldin /// dan foydalaning, masalan, funksiyalar, tiplar va xususiyatlar uchun.

Hujjatlashtirish izohlari parametrlar, qaytariladigan qiymatlar va boshqa ma’lumotlarni o‘z ichiga olishi mumkin.

Ular oddiy izohlardan kompilyator tomonidan qayta ishlanishi va hujjatlar yaratishda foydalanilishi mumkinligi bilan farq qiladi.

/// Returns the sum of two integers.
/// - Parameters: a, b
func add(_ a: Int, _ b: Int) -> Int { a + b }
print(add(2, 3))

Ushbu misolda funksiyani hujjatlashtirish uchun uchta qiya chiziqli izohlar ishlatilgan.