Пространства имён
Варианты
Действия

Комментарии

Материал из cppreference.com
< cpp

 
 
Язык С++
Общие темы
Управление программой
Операторы условного выполнения
Операторы повторения
Операторы перехода
Функции
объявление функции
объявление лямбда-функции
шаблон функции
спецификатор inline
спецификаторы исключений (устарело)
спецификатор noexcept (C++11)
Исключения
Пространства имён
объявление пространства имён
псевдонимы пространства имён
Типы
спецификатор decltype (C++11)
Спецификаторы
cv-спецификаторы
спецификаторы продолжительности хранения
спецификатор constexpr (C++11)
спецификатор auto (C++11)
спецификатор alignas (C++11)
Инициализация
Литералы
Выражения
Утилиты
Типы
typedef-объявление
объявление псевдонима типа (C++11)
атрибуты (C++11)
Приведения типов
неявные преобразования
const_cast-преобразование
static_cast-преобразование
dynamic_cast-преобразование
reinterpret_cast-преобразование
C-подобное и функциональное приведение типов
Выделение памяти
Классы
Особые свойства классовых функций
Специальные функции-члены
Шаблоны
шаблон класса
шаблон функции
специализация шаблона
упакованные параметры (C++11)
Разное
Ассемблерные вставки
 
Комментарии служить своего рода в коде документации. При вставке в программу, они фактически игнорируются компилятором, они предназначены исключительно для использования в качестве записки людей, которые читают исходный код. Хотя конкретные документации не является частью стандарта С + +, существует несколько утилит для разбора комментариев с разными форматами документов.
Оригинал:
Comments serve as a sort of in-code documentation. When inserted into a program, they are effectively ignored by the compiler; they are solely intended to be used as notes by the humans that read source code. Although specific documentation is not part of the C++ standard, several utilities exist that parse comments with different documentation formats.
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.

Содержание

[править] Синтаксис

/* comment */ (1)
// comment\n (2)
1)
Часто известные как "C-стиль" или "многоканальный" комментарии.
Оригинал:
Often known as "C-style" or "multi-line" comments.
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.

2) Зачастую известные как «комментарии в стиле C++» или «однострочные комментарии».

[править] C-стиле

C-стиля комментарии обычно используются для комментариев большие блоки текста, однако, они могут быть использованы для комментариев одиночных линий. Чтобы вставить C-стиле комментарий, просто окружают текст с /* и */, это приведет к тому, содержание комментария игнорируется компилятором. Хотя это не является частью стандарта С + +, /** и */ часто используется для обозначения документации блоков; это законно, потому что вторая звездочка просто рассматриваются как часть комментария. C-стиля комментарии не могут быть вложенными.
Оригинал:
C-style comments are usually used to comment large blocks of text, however, they can be used to comment single lines. To insert a C-style comment, simply surround text with /* and */; this will cause the contents of the comment to be ignored by the compiler. Although it is not part of the C++ standard, /** and */ are often used to indicate documentation blocks; this is legal because the second asterisk is simply treated as part of the comment. C-style comments cannot be nested.
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
C-стиля комментарии часто предпочитают в среде, где C и C + + кода могут быть смешаны, потому что они являются единственной формой комментариев, которые могут быть использованы в стандартном C (до C99).
Оригинал:
C-style comments are often preferred in environments where C and C++ code may be mixed, because they are the only form of comment that can be used in the C standard (prior to C99).
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.

[править] C + +-стиль

C-стиля комментарии обычно используются, чтобы комментировать отдельные линии, однако, несколько C + +-стиль комментарии могут быть размещены вместе, чтобы сформировать многострочные комментарии. C + +-стиль комментарии сообщить компилятору игнорировать все содержимое между // и новые линии, что делает их очень полезно.
Оригинал:
C-style comments are usually used to to comment single lines, however, multiple C++-style comments can be placed together to form multi-line comments. C++-style comments tell the compiler to ignore all content between // and a new line, which makes them very useful.
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.

[править] Пример

/* C-style comments can contain
multiple lines */
/* or just one */
 
// C++-style comments can comment one line
 
// or, they can
// be strung together
 
int main()
{
  // The below code won't be run
  // return 1;
 
  // The below code will be run
  return 0;
}