Разница в C++ между '//' и '///'

Question

Почему в коде :: Блокировки по крайней мере '///' темно-синий и '//' синий? и я видел в некоторых исходных кодах, что иногда они используют «///» и другие времена «//».

Answer 1

Не существует отличия, присущего C++.

Это просто выбор стиля, возможно перенесенный с других языков или из несвязанного инструмента.

Notepad ++ делает // comments нежирный, но /* comments */ жирным шрифтом. Такая же история: выбор стиля.

Answer 2

Это не означает ничего для C++, его то же, что и традиционный //. /// обычно используется для документации. Для CodeBlocks, это вызывает режим подсвечивает Doxygen ..

// Normal comment 
/// Doxygen comment 
//! Doxygen comment 

/*! Doxygen comment block */ 

Answer 3

Код может быть прокомментированы таким образом, чтобы производить документацию.

https://www.stack.nl/~dimitri/doxygen/manual/docblocks.html - это одна система, и некоторые IDE идентифицируют, что это так.

Answer 4

Для компилятора C++ оба являются просто комментариями.

Но инструменты для документации исходного кода, такие как , doxygen могут обрабатывать их по-разному.

Пример:

• /// -> специальный блок комментариев, например: функция документации
• // -> стандартный комментарий

/// говорит Doxygen, что этот комментарий должен быть частью созданная документация.

Answer 5

Есть инструменты, которые используют комментарии для добавления метаинформации, не используемой компилятором, а инструментами.

Например, doxygen использует специальный стиль комментариев, чтобы автоматически комментировать код для создания высококачественной документации.

Answer 6

/// является комментарием к документации, в документе Code :: Blocks должно быть что-то, что описывает его, но, например, вы должны использовать /// перед замедлением функции для документирования того, что он делает, но используйте команду// для не-документации (например, общие замечания, комментирование кода ...)

Примечания: Я не использовал Code :: Blocks, но я предполагаю, что это, как и большинство других ид C++, которые поддерживают документацию комментарии