1C·Code

1C-Code → Основы 1С → Первая программа: код, который что-то делает

Первая программа: код, который что-то делает

С нуля, без единого допущения. Что такое код, как он выполняется и как заставить его говорить.

Глава 1 из 36 · чтение примерно 18 минут

Если вы никогда не программировали — начните отсюда. Эта глава не предполагает никаких знаний вообще, даже что такое «команда» и «выполнить».

Если вы уже писали код на другом языке, пролистайте до врезки «Чем 1С отличается от привычного»: остальное будет знакомо.

Что такое программа

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

Разница важная. Если сказать человеку «посчитай сумму заказа», он разберётся сам. Машине нужно расписать: взять цену, взять количество, перемножить, показать результат. Каждый шаг отдельно и в правильном порядке.

Видов шагов немного. Всё остальное — их сочетания.

Команда, точка с запятой, порядок

Одно указание называется командой или оператором. Каждая команда заканчивается точкой с запятой — как предложение точкой.

Команды выполняются сверху вниз, строго по очереди. Пока не закончится первая, вторая не начнётся. Это кажется очевидным, но именно отсюда берётся половина ошибок новичка: обратились к тому, что появится строкой ниже.

Первая настоящая команда

Сообщить("Здравствуйте");

Часть	Что означает
Сообщить	имя команды — она показывает текст человеку
(	открывающая скобка: дальше идёт то, что команде передают
"Здравствуйте"	текст в двойных кавычках — то, что надо показать
)	закрывающая скобка: передавать больше нечего
;	конец команды

Сообщить — самая полезная команда для новичка. Она ничего не считает и не меняет, а просто показывает то, что ей дали. Когда непонятно, что происходит в программе, выводят значения и смотрят.

Комментарии: заметки для человека

Две косые черты // означают, что всё до конца строки — записка для читающего. Программа её пропускает.

Комментарии нужны не чтобы пересказать код словами. Строка // выводим приветствие рядом с Сообщить("Привет") не сообщает ничего нового. Полезный комментарий объясняет почему: почему именно так, почему не иначе, чего здесь опасаться.

Код с комментариями

// Проверка связи перед запуском обмена:
// без неё обмен падает на середине и данные остаются наполовину
Сообщить("Проверяю связь");

Часть	Что означает
//	начало комментария — до конца строки
две строки подряд	так пишут пояснение к целому куску кода
что объясняет	не «что делает строка», а зачем она здесь

Пробелы и отступы

Программе всё равно, сколько пробелов вы поставили. Сообщить( "Привет" ) и Сообщить("Привет") — одно и то же.

Людям — не всё равно. Отступы показывают вложенность: что внутри чего. Когда дойдём до условий и циклов, вы увидите, что без отступов код читать невозможно. Заведите привычку сразу: один шаг вложенности — одна табуляция.

Сообщить умеет не только текст

Передать можно и число, и результат вычисления. А тексты склеиваются знаком «плюс»: "Ито" + "го" даёт «Итого».

Разные способы вывести

Сообщить(250);                    // просто число
Сообщить(250 * 4);                // сначала посчитается, потом выведется
Сообщить("Итого: " + Строка(1000)); // текст плюс число, превращённое в текст

Часть	Что означает
250 * 4	выражение считается ДО вывода — на экран попадёт 1000
+	между текстами — склейка, а не сложение
Строка(1000)	превращает число в текст, чтобы его можно было приклеить
зачем Строка	чтобы не зависеть от порядка — почему, в следующей врезке

Как читать ошибку

Сообщение об ошибке говорит, где смотреть, и читать его надо буквально. «Ожидалось )» значит, что скобку забыли закрыть. «Переменная не определена» — что имя написано с опечаткой или строка стоит раньше, чем нужно.

В тренажёре ошибки показывают номер строки. Непонятное сообщение — повод написать нам.

Сообщения об ошибках: их четыре вида

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

Что говорит 1С и что это значит

Сообщение	Что случилось	Куда смотреть
Переменная не определена	обратились к имени, которого нет	опечатка в имени или строка, где оно создаётся, идёт ниже
Ожидается …	нарушен синтаксис: не хватает скобки, кавычки, «Тогда»	указанная строка и та, что перед ней
Метод объекта не обнаружен	у значения нет такого метода	опечатка в имени метода — или в переменной лежит не то, что вы думали
Преобразование значения … невозможно	число ждали, а пришёл текст	то, что пришло в переменную, а не строка с ошибкой
Деление на ноль	делитель оказался нулём	откуда взялся делитель — а не сама формула
Индекс находится за границами	обратились к элементу, которого нет	почти всегда ошибка на единицу

Чем ещё можно сказать что-то человеку

Сообщить — не единственная команда вывода, и в рабочем коде их различают.

Сообщить("текст") — строка в списке сообщений внизу формы. Не перебивает работу, их может быть много подряд. Это основной способ сказать «в документе не хватает склада».

Предупреждение("текст") — окно, которое нужно закрыть. Останавливает человека, поэтому им не злоупотребляют: три предупреждения подряд — это три лишних щелчка.

Вопрос(…) — окно с вариантами ответа, когда надо спросить «записать изменения?».

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

Что дальше

Вы умеете писать команды, выводить значения и читать ошибки. Это фундамент — дальше всё строится на нём.

Следующая глава — про переменные: как дать значению имя и работать с ним, а не с конкретным числом. Именно с этого код перестаёт быть списком фиксированных действий и начинает решать задачи.

Как закрепить

Читать про код и писать код — разные умения. В тренажёре к этой главе идут упражнения: вы пишете решение, оно запускается на настоящем интерпретаторе 1С и проверяется сразу, без установки платформы.

Открыть эту главу в тренажёре

→ Переменные: где программа хранит данные