Когда часть кода закомментирована, мы просто говорим, что она «закомментирована». Но когда это не закомментировано, что это?
Uncommented не совсем то же самое. Активный? Это точно не закомментировано.
Как лучше всего сослаться на процесс раскомментирования кода?
Uncommented — наиболее распространенное слово для этого.
Я называю код, который не «закомментирован», просто «кодом».
В Visual Studio есть функция "Закомментировать выбранные строки".
Противоположная функция называется "Раскомментировать выделенные строки". Я использую термин «без комментариев».
Пара возможностей:
live code для меня это звучит естественно. Хотя я удивлен, что он находится в одном списке с Legacy code - что?! Uncommented жив, но как это подразумевает наследие? Помимо того, что все является наследием, как только оно написано. ;) Извините может я просто не носитель языка.
- person n611x007; 20.12.2012
Если когда-то это было commented out в прошлом, то by uncommenting it станет
Decommented.(Вы можете recomment это, если хотите, но я не буду этого рекомендовать..)
Если это никогда не было закомментировано, это просто
code.Для меня это несколько разных (*) состояний, которые может иметь Live code. (Или, может быть, это просто йода английский.)
*: неявный потенциальный мета- [добавьте сюда латинский термин :P].
code, ожидая, когда его выберут для комментирования, разделяет эту родословную с каннабис-каннибализмом «кандидатского подражания», о… ну… неважно.
- person n611x007; 20.12.2012
Это просто кусок непрокомментированного, неотключенного, нестертого, неинактивированного, неиспользованного, неустаревшего, неустаревшего, непереписанного, неархивированного кода.
Или, говоря простым языком, код.
Подумайте о редакционном документе. Это как сказать "как называется неудаленная запись?" Просто, письменность.
Я бы хотел, чтобы это было "раскомментировано".
Я использую «возрожденный» или «восстановленный» для кода, который раньше был закомментирован, но больше не закомментирован. Я использую «живой» или «раскомментированный» для кода, который предназначен для компиляции или выполнения.
Хотя он широко используется для обозначения «живого» кода, термин «незакомментированный код» является неоднозначным. Это может относиться к коду, который когда-то был закомментирован, но был отредактирован, чтобы его можно было запустить, или он может относиться к коду, который не имеет описательных комментариев.
Я называю закомментированный код... плохой код. Если это должно быть закомментировано, просто бросьте все это вместе. Ваша система контроля версий должна отслеживать различные состояния вашей предыдущей работы. Вместо того, чтобы комментировать его для других, чтобы понять, почему он был закомментирован позже, это не кажется хорошей практикой кодирования!
Видя, как много разнородных ответов существует на этот вопрос, есть несколько вещей, которые вы должны сделать.
Выберите термин и придерживайтесь его.
Последовательность является наиболее важным. Ничего страшного, если он не самый лучший, и вы можете изменить свой выбор, если в отдаленном будущем появится более очевидный термин.
Четко опишите этот термин своим товарищам по команде.
Не говорите просто: «это означает «без комментариев» или как вы это называете». Не говорите просто: «Это противоположно комментарию». Скажите им, что это означает код, который ранее был закомментирован, а теперь его синтаксис комментирования удален. Сообщите им, что этот код теперь активен и будет выполняться при вызове. Никогда не думайте, что ваша команда достаточно умна, чтобы «просто понять это» только потому, что они кивают, когда вы используете этот термин.
В качестве субъективного ответа я использую термин без комментариев. Это плохое название для такого поведения, но, по крайней мере, оно интуитивно понятно. Это лучше, чем такая ерунда, как unhashed для языков, в которых для комментариев используется символ #.
Я честно говорю "прокомментировано". Во фразах типа «ну, это работает с этой закомментированной строкой, так что давайте закомментируем ее и перезапустим тест». «Раскомментировать» было бы более правильным, но звучит неуклюже. Однако я бы не стал использовать это выражение в официальных письмах, только в разговоре со своей парой.
Во время сеанса отладки я часто комментирую и раскомментирую строки кода.
С чисто семантической (и да, анально педантичной) точки зрения именно действие описывается фразой, а не кодом.
«Закомментировано» — это глагол, описывающий действие, посредством которого выражение было превращено в комментарий, чтобы удалить его из кода, на который воздействовал парсер языка.
Код, подвергшийся противоположному действию, то есть получению комментария и превращению его в оператор для включения его в код, на который действует синтаксический анализатор языка, будет «утвержден в». Но, конечно, это смешно.
Тем не менее, я согласен с Эндрю в том, что вне временного сеанса отладки, до того, как он будет зафиксирован, код должен быть удален, если он не используется и не оставлен в комментариях, чтобы все запутать.
Проблема с термином "закомментировано". Это злоупотребление функцией комментариев на большинстве языков. В C/C++ вы должны использовать препроцессор для условной компиляции вашего кода, например, как показано ниже:
#if 0
...
... here is the code that is not in the build
..
#endif
...
... here is the code that is in the build
...
Я вспоминаю стандарт кодирования в месте, где я работал, использовал «#ifdef NOT_DEF» и несколько других символов вместо «#if 0», чтобы добавить некоторую семантику к «закомментированному» блоку.
Термины, используемые в этой схеме, были «включенный» и «исключенный» код, хотя «включенный» обычно предполагался, когда речь шла о «коде».
Конечно, не все современные языки имеют такую функцию предварительной обработки, поэтому вы снова злоупотребляете функцией комментариев.
Я закончил тем, что закомментированный код стал кодом под комментарием, а обычный код стал кодом без комментариев. Действие: брать код из-под комментария или извлекать из-под комментария.
Мы называем это «непременным». Вы не найдете его в словаре, но это противоположность REM(d) и, что самое главное, в нем меньше слогов...
