Перечисления

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

Например, перечисление ENUM_DAY_OF_WEEK содержит константы для всех дней недели:

А перечисление ENUM_ORDER_TYPE описывает все поддерживаемые типы ордеров в MetaTrader 5:

Всего имеется несколько десятков разных перечислений. Их названия начинаются с префикса "ENUM_". Мы будем изучать их по мере продвижения по соответствующим предметным областям.

Каждое перечисление является самостоятельным типом, но их внутреннее представление одинаковое — четырехбайтовое целое (int). Каждая из констант перечисления кодируется тем или иным числом, но программисту в большинстве случаев не нужно запоминать эти числа, потому что смысл использования перечислений как раз в том, чтобы заменить внутреннее представление на понятные идентификаторы.

Компилятор следит за тем, чтобы значением перечисления всегда была одна из предопределенных констант. В противном случае возникнет предупреждение или ошибка компиляции (в зависимости от контекста, см. пример).

Вот как выглядит "внутри" перечисление ENUM_DAY_OF_WEEK (скрипт MQL5/Scripts/MQL5Book/p2/TypeEnum.mq5).

Все константы дней недели кодируются числами от 0 до 6, причем отсчет начинается с воскресенья. В принципе, константы не обязательно должны иметь последовательные номера или начинаться с 0. Существуют перечисления, где это не так.

Обратите внимание, что одни и те же константы могут означать в разных типах перечислений разные вещи. Например, для ордеров ORDER_TYPE_BUY и ORDER_TYPE_SELL в перечислении ENUM_ORDER_TYPE используются те же значения (0 и 1), что и для дней недели SUNDAY и MONDAY в перечислении ENUM_DAY_OF_WEEK.

При копировании значения из простой целочисленной переменной i в переменную перечисления x компилятор выдает предупреждение, так как на стадии выполнения программы в переменной i может оказаться величина, отличная от разрешенных констант.

В переменную y мы записываем число 1, которое соответствует MONDAY, и компилятор считает это корректной операцией.

Попытка записать константу одного перечисления в переменную другого перечисления (как MONDAY для переменной type в вышеприведенном примере) может вызвать предупреждение о неявном преобразовании одного типа в другой. Происходит это, если записываемая константа имеет такое же значение, что и один из элементов целевого перечисления. Иными словами в каждом из двух перечислений есть свой собственный элемент с соответствующим значением. Тогда компилятор делает неявное преобразование автоматически за программиста, но с помощью предупреждения просит обратить внимание и проверить, так ли все задумывалось: то, что MONDAY будет заменен на ORDER_TYPE_SELL действительно выглядит странно, но здесь мы сделали это намеренно для демонстрации.

В том случае, если копируемый элемент не совпадает по значению ни с одним элементом другого перечисления, генерируется ошибка компиляции, так как неявная конвертация невозможна (например, при записи ORDER_TYPE_CLOSE_BY в переменную day).

Закомментированная строка с переменной z также вызывает ошибку компиляции, поскольку значение 10 не принадлежит ENUM_DAY_OF_WEEK. Если программист уверен, что в каком-то экзотическом случае все же требуется записать в переменную типа перечисления произвольное значение, он может воспользоваться явным приведением типов.

О явных и неявных приведениях типов рассказывается в разделе Приведение типов.

MQL5 позволяет программисту объявлять собственные прикладные перечисления с помощью ключевого слова enum — данная возможность описана в следующем разделе Пользовательские перечисления (enum).