C++ коментарии: /* */ против //

тимлида спроси.

Если комментарий многострочный - то однозначно /* */.
Где-то видел рекомендацию, что // надо ставить только когда помечаешь говнокод, который нужно будет переделать. Потом проходишься по коду и вычищаешь все «//».
Также удобно использовать // для «переключалок» типа:

// a[i] = 1;
a[i] = 0;

Тимлид у меня на Perl специализируется :)

Вот кстати, пару случаев фейла:

/*
    Ma look, I'm nesting /* multiline */  comments
*/

/*
    std::string hello = "Hello, */ fail!";
*/

«Структурирование кода само по себе имеет большое значение. Конкретные соглашения менее важны, чем сам факт, что вы последовательно применяете определенные соглашения. Договоренности по форматированию, соблюдаемые лишь от случая к случаю, могут сильно ухудшить читаемость кода.»
(С) С. Макконнел «Совершенный код».

Книжка настоятельно рекомендуется к прочтению полностью.

как прописано в стайлгайде так и делай...

// - для однострочных комментариев, /* */ - для многострочных

// single-line comment

/*
 * multiline comment
 * if one line is not enough
 */

Вот так. Некоторые ещё любят добавлять комментарии прямо на строчку с кодом. Тогда так:

ballsize++; // your balls got bigger

Где-то видел рекомендацию, что // надо ставить только когда помечаешь говнокод,

http://www.youtube.com/watch?v=Oj4vXMRenFo

Если комментарий многострочный - то однозначно /* */.

Не всегда, смотри пример выше.

Многие среды ставят // автоматически по хоткею, что удобно для комментирования кода. Для аннотаций /* */ хорош возможностью не ограничивать свою мысль одной строкой. Для комментирования или переключения кода вручную используют #if 0 #else #endif, либо такую штуку:

    //* - убираем/добавляем снова один слеш
    int a = 5;
    /*/
    int a = 6;
    //*/

Спасибо!

> Тимлид у меня на Perl специализируется :)

молодец, чо :)

> Вот кстати, пару случаев фейла

вот поэтому у нас кодеры на с++ для коментов используют //, а для отключения кусков кода — /**/ (для больших кусков или кусков, уже содержащих /**/ — #if 0 ... #endif).

для больших кусков или кусков, уже содержащих /**/ — #if 0 ... #endif

Ну это же вообще костыль

Вы мне это объясняете или сами создали топик о том, как писать и спрашивали мнение других?

> Ну это же вообще костыль

то, что регулярно используется многими разработчиками, костылями считать не принято ;) даже древний kate, например, #if 0 ... #endif подсвечивал как комент, хотя препроцессингу он не обучен. ещё один плюс таких «коментов» — они могут быть вложенными.

Интересно, а чем

//
// multiline comment
// if one line is not enough
//

хуже, чем

/*
 * multiline comment
 * if one line is not enough
 */

?

PS: Сам чаще пользуюсь /* ... */ по старой сишной привычке.

Прошу прощения, увлёкся :)
Но видео советую посмотреть.

Кстати это одна из причин моего вопроса. Те же аннотации принято писать и так:

/// \fn someMethod
/// \brief Some description
void SomeClass::someMethod(in someArgument);

даже древний kate, например, #if 0 ... #endif подсвечивал как комент

Да оно и сейчас так :)

Вообще мне кажется, что надо придерживаться единого стиля комментариев.

Если работаешь в команде, то стиль определяется корпоративным/командным стандартом/требованиями.

Если влез в какой-то проект, то лучше придерживаться стиля, принятого в проекте.

Если сам определяешь стиль, то лучше выбрать один стиль и применять его.

Вот такое моё мнение.

PS: #if 0 ... #endif — это совсем даже не костыль. Это нормальный рабочий инструмент. Особенно для C.

use right comments Luke

#if 0
    Ma look, I'm nesting /* multiline */  comments
#endif

для больших кусков или кусков, уже содержащих /**/ — #if 0 ... #endif

Ну это же вообще костыль

это не костыль, а директива препроцессора

Блин… Было же у Майерса…

Doxygen-то зачем сюда впутывать? Хоть то же самое можно записать и как

/**
 * \fn someMethod
 * \brief Some description
 */
 void SomeClass::someMethod(in someArgument);

А кто сказал, что хуже? В виме первый вариант ставится (и уюирается) на раз

Для многострочных переключалок :

    int some;
    /* * /
    some = 1;
    java.lang.System.out.print("multiline.stuff");
    /*/
    some = 2;
    java.lang.System.out.print("other.multiline.stuff");
    //*/

    //убираем один пробел и тыньс!

    int some;
    /* */
    some = 1;
    java.lang.System.out.print("multiline.stuff");
    /*/
    some = 2;
    java.lang.System.out.print("other.multiline.stuff");
    //*/

спасибо за «хреначь код (и коменты туда же)»

ну и замечание что при наличии контроля версий коментарии перемещаются в замечания системы контроля и нефиг их сувать в код.

ТСу:

чель кури историю

// из В в который попало из CPL

/* */ из Алгола

так что коментируй как тебе удобно т.е придерживайся стиля(однородности) единообразия .

всё просто.

// чтобы было видно в диф файле, что коммент исправил, а не что-то ещё

При чём тут Development?

Или ты комплексуешь, что у тебя маленький... скор?

На си не пишу. Для того на чем пишу использую NERD_commenter - он ставит однострочные, если бы не использовал NERD_commenter, то всеравно бы ставил однострочные, т.к. CTRL-Q. А вообще, как генератор документации требует, так и приходится писать.

На днях заинтересовал вопрос, а какие же комментарии лучше использовать для С++, /* */ или // ?

профессор, вы бороду под одеяло или на одеяло кладёте?

ответ прост

//однострочные

/* * * многострочные * */

#if 0 ... #endif — это совсем даже не костыль

да. особенно учитывая его возможность замены на #ifdef DEBUG например.

на подсознательном уровне первое вызывает неприязнь(кастую психологов) :)

и как ты по-другому закомментишь, например, такой метод?

void SomeClass::someMethod(int param = /* = 0 */)
{
...
}

#if 0 #endif единственный вменяемый вариант

Как уже писали выше:

// однострочный комментарий

/* многострочный
   комментарий */

Но я заметил, что многие здесь путают именно комментарии с исключением кода. По всей видимости нелогичное по своей сути выражение «закомментировать код» прочно въелось в подкорку рядового программиста. Добавить комментарий к коду можно как показано выше, а под «закомментированием кода» понимается его исключение, для этого есть условная сборка механизмами препроцессора:

Быстрое исключение кода (для себя):

#if 0
    // oneline comment here
    foo();

    /* multiline comment
       there */
    bar();
#else
    // do something else
    baz();
#endif

Подробное исключение кода (для VCS):

#ifdef USE_DECRECATED_SOLUTION
    ...
#else
    ...
#endif

на подсознательном уровне первое вызывает неприязнь

У кого?

У меня не вызывает. Вполне себе комментарий.

Очевдно же - у меня :) От // в глазах рябит. Особенно когда делают так:

////////////////////////////////////////////////////////////////
//////
// This is a comment
// A multiline one.
/////
////////////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////

Так это без разницы. Например, мне встречалось и такое:

/**************************************************************************/
/**************************************************************************/
/*                                                                        */
/* This is                                                                */
/* myBestFuncion( int a, char b, float c )                                */
/**************************************************************************/
/***************************                   ****************************/
/****                                                                  ****/
/* a - number of characters                                               */
/****                                                                  ****/
/* b - character for multiplex                                            */
/****                                                                  ****/
/* c - f#cking something (abstruse)                                       */
/**************************************************************************/
/**************************************************************************/

От такого не рябит? :)

Тут дело-то не в конкретных символах, обозначающих комментарии, а в том, как их используют.

Исключительно //, так как проблемы /* */ всем известны. Единственное исключение для /* */ - это doc string.

Ну и все вменяемые среды умеют комментить // (и убирать комменты) для выделеного текста по хоткею.

А в некоторых языках даже и нет многострочных комментов, например Python (хотя можно конечно использовать тройные кавычки для этого).

Надо рабочий код писать, а не страдать над стилем комментариев.

А я думал, баннер из каментов уже никто не запостит :)

не выкладывай такое больше. Вообще смотря что комментировать, сам должен быть самодокументированным, это уже говорили? Если длительное описание тогда /* * Cool text here */

Если быстро закомментировать и протестить тогда // - Тогда легче строка за строкой раскомментировать

не выкладывай такое больше.

Я и не собирался, но поддался на провокацию. :)

Больше не буду.

Это криминал? :)

Но вообще-то я, конечно, зря повёлся на провокацию.

Хз что есть криминал, просто насмотрелся на такой кодстайл, а в этом треде долго не было.

просто насмотрелся на такой кодстайл

Вот и я тоже. До тошноты. Удивляюсь, как людям не лень такой фигнёй заниматься, ведь пустая трата времени же. :)

Хорошо сказано. Но следить за стилем кода тоже важно (если его придётся поддерживать).

Единственное исключение для /* */ - это doc string.

Так можно доки/аннотации писать как я привёл пример тут: C++ коментарии: /* */ против // (комментарий)