Когда фрагмент кода прокомментирован, мы говорим именно это, он "закомментировал". Но когда он не прокомментировал, что это такое?
Без комментариев не совсем то же самое. Активный? Это определенно не прокомментировано.
Какой лучший способ обратиться к акту снятия комментариев с кода?
Я закончил тем, что прокомментировал код как код под комментарием, а обычный код - код не под комментариями. Действие, принимающее код из комментария или вывод из комментария.
Я вызываю код, который не "прокомментирован" просто "код"
Uncommented является наиболее распространенным словом для этого.
Пара возможностей:
Visual Studio имеет функцию "Комментировать выделенные строки".
Противоположная функция называется " Uncomment выделенные строки". Я использую термин "uncommented".
Это просто фрагмент un-out-commented, un-disabled, un-erased, un-инактивированный, неиспользуемый, не устаревший, не устаревший, непереписанный, неархивированный код.
Или, в непрофессиональных условиях, код.
Подумайте над редакционным документом. Его вроде как сказать "что называется не удаленной записью?" Просто, письмо.
Мне жаль, что он не был раскопан.
Я использую "восстановленный" или "восстановленный" для кода, который использовался для комментирования, но больше не существует. Я использую "live" или "uncommented" для кода, который должен быть скомпилирован или выполнен.
Если раньше он был commented out, тогда by uncommenting it он станет
Decommented.(Вы можете recomment его, если хотите, но я не буду рекомендовать это..)
Если это никогда не было прокомментировано, просто
code.Это для меня сейчас несколько различных состояний (*), которые могут иметь a Live code. (Или, может быть, это просто йода английский.)
*: неявный потенциал мета- [добавить свой латинский термин здесь: P].
Хотя он широко используется для обозначения "живого" кода, "Uncommented code" - неоднозначный термин. Он может ссылаться на код, который когда-то был прокомментирован, но был отредактирован, чтобы позволить ему запускаться, или он может ссылаться на код, который не содержит описательных комментариев.
Я вызываю код с комментариями... плохой код. Если это нужно прокомментировать, просто перекиньте все это вместе. Ваша система контроля версий должна отслеживать различные состояния вашей предыдущей работы. Вместо того, чтобы комментировать его для других, чтобы понять, почему он был прокомментирован позже, похоже, не является хорошей практикой кодирования!
Увидев, сколько разных ответов существует для этого вопроса, вы должны сделать несколько вещей.
Выберите термин и придерживайтесь его.
Консистенция важна. Это нормально, если это не лучший из всех, и вы можете изменить свой выбор, если в отдаленном будущем появится более очевидный термин.
Явно описываю этот термин для ваших товарищей по команде.
Не просто сказать: "Это означает, что вы без комментариев, или как вы его называете". Не просто сказать: "Это противоположность прокомментированному". Скажите им, что это означает код, который ранее был прокомментирован, и теперь удалил синтаксис комментария. Скажите им, что этот код теперь активен и будет выполняться при вызове. Никогда не предполагайте, что ваша команда достаточно умна, чтобы "просто получить ее" только потому, что они кивают, когда вы используете термин.
Как субъективный ответ, я использую термин uncommented. Это плохое имя для поведения, но, по крайней мере, оно слегка интуитивное. Он бьет вздор, как unhashed для языков, которые используют символ # для комментариев.
Я честно говорю "прокомментировал". В таких фразах, как "хорошо, он работает с этой строкой, прокомментировал это, так что давайте прокомментировать это и снова запустить тест". "Раскол" был бы более правильным, но звучит clunkier. Я бы не использовал это выражение в формальном письме, хотя, просто разговаривая с моей парой.
Во время сеанса отладки я часто комментирую и раскомментирую строки кода.
От чисто семантической (и да, анально педантичной) перспективы, это действие, которое описывается фразой, а не код.
"Commented Out" - это глагол, описывающий действие, в результате которого оператор был превращен в комментарий, чтобы удалить его из кода, на который воздействует парсер языка.
Кодекс, подвергшийся противоположному действию, который должен принять комментарий и превратить его в выражение, чтобы включить его в код, на который действует синтаксический анализатор языка, будет "Утвержденный". Но, конечно, это смешно.
Тем не менее, я согласен с Андреем в том, что за пределами переходного сеанса отладки перед его выполнением код следует удалить, если он не используется и не оставлен в комментариях, чтобы запутать вещи.
Проблема заключается в термине "закомментировано". Это злоупотребление комментарием большинства языков. В 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", чтобы добавить некоторую семантику в блок "commented out".
Термины, используемые в этой схеме, были "включены" и "исключены" кодом, хотя "включение" обычно принималось при общем разговоре о "коде".
Конечно, не все современные языки имеют такую функцию предварительной обработки, поэтому вы снова злоупотребляете функцией комментариев.
Мы называем это "unremd". Вы не найдете его в словаре, но это противоположность REM (d) и, самое главное, имеет меньшее количество слогов...