Основы Swift / 2.3. Комментарии


Видео


Комментарии
Используйте комментарии для включения неисполняемого текста в Ваш код в качестве заметки или напоминания себе. Комментарии игнорируются компилятором Swift во время сборки программы. Инструкции из них не только не будут распознаны, но и всё содержимое комментария не будет добавлено в результирующую программу.

Однострочные комментарии начинаются с двух прямых слэшей (//):
@{2.3\1}
                    
//Это комментарий
                    
                
Многострочные комментарии
Многострочные комментарии начинаются с прямого слэша со знаком звёздочки (/*) и оканчиваются символом звезды и прямым слэшем (*/):
@{2.3\2}
                    
/*
 Это тоже комментарий,
 но написанный в несколько строк.
 */
                    
                
Вложенные многострочные комментарии
Многострочные комментарии в Swift могут быть вложенными. Вы можете написать вложенные комментарии, начав писать один блок многострочных комментариев и начав внутри него другой. Второй блок затем закрывается, и продолжается первый.

Вложенные многострочные комментарии позволяют Вам комментировать большие части кода быстро, даже если этот код уже содержит многострочные комментарии.

Старайтесь писать в комментариях не то, что делает код, это и так будет понятно из написанного, а почему он это делает. Описывайте нестандартные решения и конструкции, назначение которых неочевидно.
@{2.3\3}
                    
/* Это начало многострочного комментария
/*Это вложенный многострочный комментарий*/
Это конец многострочного комментария */