«Капитально»
  • Программирование
    • Администрирование
    • Внедрение 1С
    • Изучение 1С
    • Запросы
    • СКД
    • Интерфейс
      • Обычные формы
      • Управляемые формы
    • Мобильная разработка
    • Ошибки в работе 1С
  • Бухгалтерия
  • Торговля
  • Изучение 1С: с чего начать?
    • Требуется консультация?
  • О сайте
Товар добавлен в корзину
Главная Программирование 1С8 Изучение 1С Язык программирования 1С Комментирование кода 1С

Комментирование кода 1С

23.01.2016WebMaster

Комментирование кода —  это внесение пояснений в тест модулей, которые не является обязательными и не влияют на алгоритм (не исполняются)

Производится только с помощью последовательности «//«, при этом комментарием считается все, что находится после.

Пример комментария:

Перем ЭтоНеКомментарий;\\ А это уже комментарий \\Это тоже комментарий

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

Возможно использование в подряд идущих комментариев:

//Это первая строка комментария
//Это вторая строка комментария

//Строка комментария после пустой строки 
// Перем А;//Эта переменная не объявится

Горячие клавиши

ctrl + / — добавить комментарий в выделенных строках;

ctrl + shift + / — удалить комментарий в выделенных строках

В данном случае комментарий, конечно, не удаляется, а удаляется символы комментирования из каждой строк выделенного блока

Установка и снятие комментария интерактивно по кнопкам:

Выделяется код и нажимаются на панели «Модуль» соответствующие кнопки «Добавить комментарий» и снять «Комментарий»

 

Снятие комментария

или более длинный путь:

Меню «Текст\Блок\Добавить комментарий» или «Текст\Блок\Удалить комментарий«

Установка комментарие длинный путь

 

Должен заметить, что текст комментариев —  только для программистов, пользователь его не увидит, и служит для:

  • описания сложных участков кода или алгоритма
  • логического отделения блоков непрерывного кода, в данном случае поле «\\» ничего не пишется
  • описания функций и процедур
  • выделения изменений в код типовых конфигураций, при обновлении упростит разбор
  • описания ситуации внесения изменений, даты
  • отметка ошибочного или сомнительного кода, в процесcе code review (анализа  качества кода 1С)

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

Среда разработки может автоматически сворачивать комментарии, для удобства восприятия

Настроить это можно в меню «Сервис\Параметры» далее вкладки «Модули\Группировка»

Сворачивание комментариев

Там же на вкладке «Модули\Редактирование» возможно отключить или поменять цвет выделения комментария с зеленого (по умолчанию)

Модули Редактирование

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

 

Один миллион, вложенный в эффективную рекламу, продает больше, чем десять миллионов, вложенных в неэффективную рекламу… Плохая реклама может и совсем отпугнуть покупателя.

— Дэвид Огилви
: 1с синтаксис языка
Предыдущая запись 1С объявление переменных Следующая запись Типы значений 1С

Также в этом разделе

  • 1С объявление переменных

  • Дополнительные реквизиты объектов с помощью плана видов характеристик

  • Как в печатной форме выводить номер страницы

  • Как открыть заполненной новую запись регистра сведений

  • Как очистить регистр сведений?

  • Ключ записи регистра сведений для открытия ее формы

  • Комментирование кода 1С

  • Ожидается константа типа Число, Строка, Дата или Булево

  • Параметры сеанса: создание и использование

  • Поле объекта недоступно для записи (АвтоРазмер)

  • Сбросить счётчик нумерации документов или справочников в 1С

  • Структура кода модулей

  • Типы значений 1С

  • Чтение и запись текстовых файлов в 1С 8

  • Язык в программе «1С»

Предложения

  • Азбука программирования в 1С:Предприятие 8.3 (в электронном виде) 247,00 руб.
  • 1С:Предприятие 8.3. Бухгалтерия предприятия. Управление торговлей. Управление персоналом 142,00 руб.
  • 1С. Управление торговлей 8.3. 100 уроков для начинающих 239,00 руб.
  • Азбука программирования в 1С:Предприятие 8.3 376,00 руб.
  • Конфигурация 1С для учёта весовых 12500,00 руб.

 

Реклама
Опросы
Карта сайта

Copyright © Роман Владимирович Третьяков, 2015-2017. Цитирование материалов допустимо только с указанием активной ссылки на Capitally.ru. Соглашение.