Self-learning the MQL5 language from scratch - page 13

 

I noticed that I missed the first two scripts. The first New.mq5 script explains what a comment is. As I promised earlier, I tried to describe everything in this script for a 1st class student of a programming school.

Best regards, Vladimir.

//+------------------------------------------------------------------+
//|                                                          New.mq5 |
//|                        Copyright 2020, MetaQuotes Software Corp. |
//|                                             https://www.mql5.com |
//+------------------------------------------------------------------+
#property copyright "Copyright 2020, MetaQuotes Software Corp."
#property link      "https://www.mql5.com"
#property version   "1.00"

/* Уважаемые друзья! С данного скрипта мы начинаем обучение азам программирования на языке MQL5.
   Обучение основано на информации полученной из Справочника MQL5, а также много информации взято
   из учебника Сергея Ковалёва, расположенного по ссылке https://book.mql4.com/ru/basics/common.
   Любое обучение начинается с элементарных понятий, некоторые из них мы рассмотрим в данном скрипте.
   Для начала давайте разберемся, что такое скрипт. Скрипт в переводе с английского языка означает
   сценарий, т.е. текст с подробным описанием. В каждом скрипте нам придется комментировать все
   действия, которые будем осуществлять при его написании.   
   
   Понятие комментария 

   Программа состоит из двух видов записей: тех, которые составляют собственно программу, и тех, которые 
   являются лишь пояснительным текстом к ней. Комментарий - это необязательная и неисполняемая часть программы.
   Готовая программа будет работать в соответствии с заложенным в неё кодом независимо от того, есть в ней 
   комментарии или нет. Однако комментарии очень облегчают понимание кода программы. 
   
   Комментарии могут быть однострочными и многострочными.
    
   Однострочный комментарий - это любая последовательность символов, перед которой стоят две косые черты (//). 
   Признак однострочного комментария заканчивается вместе с переводом строки. 
   
   Многострочный комментарий начинается символами /* и заканчивается символами */

// ПРИВЕДЁМ ПРИМЕРЫ КОММЕНТАРИЕВ
   
/* ... <-Это начало многострочного комментария,
   ...
   ...
   ... а конец многострочного комментария показан строчкой ниже.
*/

//+------------------------------------------------------------------+
//| Script program start function                                    | <-Это блок комментария о старте скрипта
//+------------------------------------------------------------------+
void OnStart()
  {
//---    <-Это однострочный комментарий
//       <-Это однострочный комментарий
  }
//+------------------------------------------------------------------+ <-Это однострочный комментарий
 
Vasiliy Sokolov:

... Don't confuse the young man.)

Thanks a lot for the young man! I'm serious - I want to feel young!

Regards, Vladimir.

 
There have been several such threads in the last two years. All of them started enthusiastically, but after a month they disappeared and the thread disappeared and the forum members lost interest.
Once again, without an answer to the question Why learn the language, the thread will be forgotten
 
Vladimir Baskakov:
There were a few of such threads during the last two years. All of them started with enthusiasm but a month later they all disappeared and the threads disappeared and the forum users lost interest.
Once again, without an answer to the question Why learn the language, the branch is waiting for oblivion.

Hello Vladimir, I agree with you. But so far there's been no talk about all forum members having an interest in the topic. The thread does not claim to be a leader. It's possible that newbies with zero programming knowledge read this thread and start getting involved in the learning process. Here I am sharing the knowledge I received in the process of self-education and reinforced with the codes of scripts, written by myself without anyone else's help! Scripts I post in order to have at least some feedback from forum participants. If this thread will disappear, it will be a signal that the level of knowledge obtained as a result of self-study has reached the desired level.

What I am advised and counseled by experienced programmers, I take into consideration. I respect your point of view!

Regards, Vladimir.

 

In the New1.mq5 script, a method for printing a welcome message was considered and a glossary of terms was added. In this script, I tried to paint everything, as I promised earlier, in an accessible presentation for a student of the 1st grade of a programming school.

With best regards, Vladimir.

 //+------------------------------------------------------------------+
//|                                                         New1.mq5 |
//|                        Copyright 2020, MetaQuotes Software Corp. |
//|                                             https://www.mql5.com |
//+------------------------------------------------------------------+
#property copyright "Copyright 2020, MetaQuotes Software Corp."
#property link        "https://www.mql5.com"
#property version    "1.00"
/* Продолжаем обучение азам программирования на языке MQL5. Чтобы посмотреть первый результат
   практического применения кода скрипта, мы напишем функцию вывода на печать какого-нибудь
   сообщения. Давайте, например, пожелаем всем доброго дня и хорошего настроения!
   Для этого нам нужно после "void OnStart() {" указать функцию Print() и внутри двойных
   круглых скобок написать приветствие, заключённое ещё и в двойные кавычки. 
*/

// ПИШЕМ КОД СКРИПТА

//+------------------------------------------------------------------+
//| Script program start function                                    |
//+------------------------------------------------------------------+
void OnStart ()
  {
//---
   Print ( "Всем доброго дня и хорошего настроения!" );

  }
//+------------------------------------------------------------------+

/* Теперь сделаем некоторые пояснения, которые касаются непосредственно самого кода скрипта, а так же
   где и как посмотреть результат выполнения этого кода. Начнем с того, что после блока комментария
   Script program start function (что переводится, как Функция запуска скриптовой программы) мы видим
   не известное нам "void OnStart()". Чтобы узнать, что же это такое, нам нужно обратиться к
   Справочнику MQL5. Для этого делаем так: устанавливаем мышкой курсор на непонятное нам словосочетание
   и на клавиатуре нажимаем клавишу F1 (Вызов справки). Сразу откроется небольшое подокно с 
   предложением выбора раздела. Оставляем всё как есть и жмём на кнопку "Показать". После того,
   как откроется Справочник MQL5, мы видим с правой стороны справочника текстовое описание:
   "OnStart. Функция OnStart() является обработчиком события Start, которое автоматически генерируется 
   только для запущенных на выполнение скриптов. Должна иметь тип void, т.к. параметров 
   не имеет: void OnStart();". Вот теперь мы узнали для чего нужна строка с этим кодом.
   Двигаемся дальше. А дальше мы видим две фигурные скобки "{" и "}". Снова обращаемся к справочнику,
   но он почему-то не даёт каких-либо определений по фигурным скобкам. Всё дело в том, что эти
   фигурные скобки являются частью функции (в нашем случае функции void OnStart()). Открываем в
   справочнике раздел "Функции", там находим то, что нас интересует: "Функции. Всякая задача может быть
   разбита на подзадачи, каждую из которых можно либо непосредственно представить в виде кода, либо 
   разбить на еще более мелкие подзадачи. Данный метод называется пошаговым уточнением. Функции служат 
   для записи программного кода этих непосредственно решаемых подзадач. Код, описывающий, что делает 
   функция, называется определением функции:
   
   заголовок_функции
     {
      инструкции
     }
   
   Все, что находится перед первой фигурной скобкой, составляет заголовок определения функции, а то,
   что находится между фигурными скобками, является телом определения функции. Всё понятно? Отлично.
   Вот теперь мы дошли до того момента, когда нужно указать нашу инструкцию (в данном случае - функцию Print,
   т.е. печать), которую должен будет выполнить данный скрипт.  Снова обратимся к Справочнику MQL5. Находим
   раздел Print: "Print. Печатает некоторое сообщение в журнал экспертов. Параметры могут иметь любой тип".
   Запомнили куда печатается сообщение? Правильно, в журнал экспертов, который находится в торговом 
   терминале MetaTrader 5. Давайте запомним и ещё одно уточнение: раз мы решили писать текстовое приветствие,
   то этот текст нужно взять в двойные кавычки, т.е. вот так - "Всем доброго дня и хорошего настроения!".
   Вот теперь всё! Открываем торговый терминал MetaTrader 5 (нажимаем клавишу на клавиатуре F4), двойным
   щелчком мышки запускаем скрипт New1.mq5 и во вкладке "Эксперты" читаем наше приветствие.
*/

// ОЧЕНЬ ВАЖНАЯ ИНФОРМАЦИЯ!

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

   СЛОВАРЬ ТЕРМИНОВ (ссылка на книгу Сергея Ковалёва https://book.mql4.com/ru/appendix/glossary)

   Алгоритм - точное предписание выполнить заранее определённую последовательность действий;
   управление в исполняемой программе передаётся в соответствии с алгоритмом.

   Бар - графическая форма представления графика развития цены. Бар характеризуется: ценой открытия (Open),
   ценой закрытия (Close), максимальной ценой (High), минимальной ценой (Low), объёмом (Volume)
   и временем открытия (Time) (см. также Свеча).

   Буфер - область памяти, содержащая численные значения индикаторного массива.

   Валютный инструмент - валютная пара, например, EUR/USD, GBP/CHF; частный случай финансового инструмента.

   Внешняя переменная - переменная, значение которой доступно из окна свойств программы; обладает свойствами
   глобальной переменной.

   Встречный ордер - рыночный ордер, открытый в противоположном направлении по отношению к другому
   рыночному ордеру по тому же финансовому инструменту.

   Встроенная функция - то же, что стандартная функция.

   Вызов функции (то же, что обращение к функции) - запись, исполнение которой приводит к исполнению
   функции (см. также Описание функции).

   Выражение - последовательность операндов и операций; запись в программе, вычисленное значение которой
   характеризуется типом данных.

   Глобальная переменная - переменная, объявленная за пределами всех функций. Областью видимости
   глобальных переменных является вся программа.

   Глобальная переменная клиентского терминала - переменная, значение которой доступно из всех прикладных
   программ, запущенных на клиентском терминале (сокращённо - GV-переменная).

   Графический объект - изображение в окне финансового инструмента, которое можно выделить, переместить,
   изменить или удалить.

   Двухсторонняя котировка - связанная пара рыночных цен, предлагаемых брокером для осуществления покупки
   и продажи активов по финансовому инструменту в текущий момент.

   Заголовок функции - составная часть описания функции; состоит из указания типа возвращаемого значения,
   названия функции и списка формальных параметров. Список формальных параметров заключается в круглые скобки
   и располагается после названия.

   Зацикливание - бесконечное повторяющееся выполнение операторов, составляющих тело цикла; критическая
   ситуация, возникающая в результате реализации ошибочного алгоритма.

   Знак операции - предопределённый символ или группа символов, предписывающих выполнить некоторую операцию.

   Идентификатор переменной - набор символов, состоящий из букв, цифр и знака подчеркивания, начинающийся
   с буквы, длиной не более 31 символа. То же, что Имя переменной и Название переменной.

   Имя переменной - то же, что идентификатор переменной.

   Индикатор - встроенная функция клиентского терминала или программа, составленная на языке MQL4;
   основным назначением индикаторов является отображение на экране индикаторных линий; у индикаторов
   отсутствует возможность осуществления торговых операций; различают пользовательские и технические индикаторы
   (см. также эксперт, советник и скрипт).

   Индикаторная линия - графическое отображение на экране некоторой зависимости, построенной на основе 
   численных значений, содержащихся в индикаторном массиве.

   Индикаторный массив - одномерный массив, содержащий численные значения, в соответствии с которыми строится 
   индикаторная линия.

   Инициализация переменной - присвоение переменной значения, соответствующего её типу,
   при объявлении переменной.

   Итерация - повторное выполнение некоторых вычислений; используется для обозначения факта исполнения
   программных строк, составляющих тело оператора цикла (см. Оператор цикла while и Оператор цикла for).

   Комментарий - необязательная и неисполняемая часть программы.

   Константа - составная часть программы; объект, имеющий значение.

   Константное выражение - выражение, состоящее из констант и операций, например: 2+3*7 .
   Константное выражение вычисляется на этапе компиляции программы.

   Локальная переменная - переменная, объявленная внутри какой-либо функции. Областью видимости локальных
   переменных является тело функции, в которой эта переменная объявлена.

   Локальное время - время, установленное на локальном компьютере (см. также серверное время).

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

   Название переменной - то же, что идентификатор переменной.

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

   Нормализованная цена - цена, округлённая с точностью до размера одного пункта по финансовому инструменту.

   Нормальный выход из цикла - передача управления за пределы оператора цикла в результате исполнения
   условия, содержащегося в заголовке оператора цикла (см. также специальный выход из цикла).

   Область видимости переменной - место в программе, в котором доступно значение переменной. Каждая
   переменная имеет свою область видимости (см. также локальная переменная и глобальная переменная).

   Обращение к функции - то же, что Вызов функции.

   Объявление переменной - первое упоминание переменной в программе. При объявлении переменной указывается её тип.

   Операнд - константа, переменная, элемент массива или значение, возвращаемое функцией константа, переменная,
   элемент массива или значение, возвращаемое функцией (см. Вызов функции).

   Оператор - составная часть программы; фраза алгоритмического языка, предписывающая определённый порядок
   преобразования информации. Различают простые и составные операторы.

   Операция - действие, производимое над операндами (см. также знак операции).

   Описание функции - именованная, обособленная часть программы, предназначенная для исполнения; состоит из
   двух основных частей - заголовка функции и тела функции; используется применительно к специальным и
   пользовательским функциям (см. Функции, Описание функции и оператор return и Специальные функции).

   Отложенный ордер - торговый приказ на покупку или продажу активов по финансовому инструменту при достижении
   заданного значения цены. Отложенный ордер отражается в окне финансового инструмента и в окне "Терминал" до
   тех пор, пока он не преобразуется в рыночный ордер либо будет удалён (см. также рыночный ордер).

   Переменная - составная часть программы; объект, имеющий название и значение.

   Пользовательская функция - функция, созданная программистом (см. Функция).

   Пользовательский индикатор - прикладная программа, составленная на языке MQL4 и MQL5, основным назначением 
   которой является графическое отображение на экране рассчитанных зависимостей. Значения элементов индикаторных
   массивов пользовательского индикатора доступны другим прикладным программам через функцию iCustom()
   (см. также технический индикатор).

   Предопределённая переменная - переменная с предопределённым названием, значение которой определяется
   клиентским терминалом и не может быть изменено программным способом (см. Предопределённые переменные).

   Приведение типов - изменение (преобразование) типа значения операнда или выражения. Перед выполнением операций
   (кроме операций присваивания) происходит преобразование в тип, имеющий наибольший приоритет, а перед
   операциями присваивания - в целевой тип.

   Прикладная программа - программа, написанная на языке MQL4 и MQL5, используемая в клиентских терминалах
   MetaTrader 4 и MetaTrader 5; эксперт, скрипт или индикатор.

   Пункт - единица измерения цены по финансовому инструменту (минимально возможное изменение цены,
   последняя значащая цифра в значении цены).

   Рыночный ордер - исполненный приказ на покупку или продажу активов по финансовому инструменту.
   Рыночный ордер отображается в окне финансового инструмента и в окне "Терминал" до тех пор, пока
   не выполнен приказ на закрытие ордера (см. также отложенный ордер).

   Свеча - графическая форма представления графика развития цены. Свеча характеризуется:
   ценой открытия (Open), ценой закрытия (Close), максимальной ценой (High), минимальной ценой (Low),
   объёмом (Volume) и временем открытия (Time). Различают чёрные и белые свечи (см. также бар).

   Серверное время - время, установленное на сервере (см. также локальное время).

   Скрипт - программа, составленная на языке MQL4 и MQL5; отличается свойствами специальной функции start(),
   вызываемой клиентским терминалом для исполнения один раз; назначением скриптов является выполнение
   любых операций, которые по их смыслу требуется выполнить один раз (см. также эксперт, советник и индикатор).

   Советник - то же, что эксперт (см. также скрипт и индикатор).

   Специальная функция - функция, имеющая одно из предопределённых имён (init(), start() и deinit())
   вызываемая для исполнения клиентским терминалом и обладающая специальными собственными свойствами
   (см. специальные функции).

   Специальный выход из цикла - передача управления за пределы оператора цикла в результате исполнения
   оператора break, содержащегося в теле оператора цикла (см. также нормальный выход из цикла).

   Спред - разница между большей и меньшей ценой в двухсторонней котировке по финансовому инструменту,
   выраженная в пунктах.

   Стандартная функция - то же, что Встроенная функция; функция, созданная разработчиками языка MQL4,
   имеющая предопределённое имя и свойства; описание стандартных функций в программе не указывается;
   свойства стандартных функций подробно описаны в справочной документации (см. Функции и Стандартные функции ).

   Массив-таймсерия - массив с предопределённым названием (Open, Close, High, Low, Volume или Time),
   элементы которого содержат значения соответствующих характеристик исторических баров.

   Таймфрейм - период времени, в течение которого формируется один ценовой бар; различают стандартные
   таймфреймы: М1, М5, М15, М30, Н1, Н4, D1, W1 и MN (1 мин, 5 мин, 15 мин, 30 мин, 1 час, 4 часа, 1 день,
   1 неделя и 1 месяц, соответственно)

   Тело функции - один или несколько операторов, являющих исполняемую часть описания функции.

   Тело цикла - один или несколько операторов, обрамлённых фигурными скобками; располагается непосредственно
   после заголовка оператора цикла (см. Оператор цикла while и Оператор цикла for).

   Технический индикатор - составная часть информационно-торговой системы MetaTrader 4, встроенная функция,
   позволяющая графически отображать на экране определённую зависимость (см. также пользовательский индикатор).

   Тик - событие, характеризующееся новой ценой по финансовому инструменту в некоторый момент времени.

   Торговая операция - открытие, закрытие или модификации рыночных и отложенных ордеров.

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

   Трейдер - человек, который занимается торговлей на финансовых рынках с целью получения прибыли.

   Управление - процесс выполнения действий, предопределённых алгоритмом программы и свойствами
   клиентского терминала. Управление может передаваться внутри программы от одной программной строки к другой,
   а также между программой и клиентским терминалом (см. Некоторые основные понятия).

   Файловый описатель – уникальный номер файла, открытого исполняемой программой в текущий момент.

   Файловый разделитель - специальный символ; запись, которая заносится в файл для разделения записей данных.

   Файловый указатель - место в файле, с которого начинается чтение следующего значения. По мере прочтения
   данных файловый указатель смещается вправо на одну или несколько позиций.

   Финансовый инструмент - название котируемого объекта.

   Флаг - переменная, значение которой ставится в соответствие каким-либо событиям или фактам.

   Формальные параметры - список переменных, указанных в заголовке описания функции (см. Функции и Описание
   функции и оператор return).

   Формат оператора - набор правил форматирования, присущих виду оператора. Каждый вид оператора имеет
   свой формат (см. Операторы).

   Функция - именованная, обособленная часть программы, описывающая порядок преобразования информации.
   Использование функции в программе предполагает наличие описания функции и вызова функции.
   Различают специальные, стандартные (встроенные) и пользовательские функции
   (см. Функции и Специальные функции ).

   Эксперт - программа, составленная на языке MQL4 и MQL5; отличается свойствами специальной функции start(),
   вызываемой клиентским терминалом для исполнения на каждом тике; основным назначением экспертов
   является программное управление торговыми операциями (см. также советник, скрипт и индикатор).

   Элемент массива - составная часть массива; индексированная переменная с одноимённым названием,
   имеющая некоторое значение.

   Ask - большая из цен в двухсторонней котировке по финансовому инструменту, предлагаемая брокером.

   Bid - меньшая из цен в двухсторонней котировке по финансовому инструменту, предлагаемая брокером.

   Buy - рыночный ордер, определяющий покупку активов по финансовому инструменту.

   BuyLimit - отложенный ордер на покупку активов по финансовому инструменту по цене ниже текущей.
   Ордер исполнится (преобразуется в рыночный ордер Buy), если цена Ask достигнет или окажется ниже
   цены, заявленной в ордере.

   BuyStop - отложенный ордер на покупку активов по финансовому инструменту по цене, превышающей
   текущую цену. Ордер исполнится (преобразуется в рыночный ордер Buy), если цена Ask достигнет или
   окажется выше цены, заявленной в ордере.

   GV-переменная - то же, что глобальная переменная клиентского терминала.

   Sell - рыночный ордер, определяющий продажу активов по финансовому инструменту.

   SellLimit - отложенный ордер на продажу активов по финансовому инструменту по цене, превышающей
   текущую цену. Ордер исполнится (преобразуется в рыночный ордер Sell), если цена Bid достигнет или
   окажется выше цены, заявленной в ордере.

   SellStop - отложенный ордер на продажу активов по финансовому инструменту по цене ниже текущей.
   Ордер исполнится (преобразуется в рыночный ордер Sell), если цена Bid достигнет или окажется
   ниже цены, заявленной в ордере.

   StopLoss - стоп-приказ; заявленная цена, по которой рыночный ордер будет закрыт при движении
   цены финансового инструмента в сторону убытков по ордеру.

   TakeProfit - стоп-приказ; заявленная цена, по которой рыночный ордер будет закрыт при движении
   цены финансового инструмента в сторону прибыли по ордеру.
*/
 

Just finished writing the code for a new script. Here's a description of it:

//+------------------------------------------------------------------+
//|                                                         New6.mq5 |
//|                        Copyright 2020, MetaQuotes Software Corp. |
//|                                             https://www.mql5.com |
//+------------------------------------------------------------------+
#property copyright "Copyright 2020, MetaQuotes Software Corp."
#property link      "https://www.mql5.com"
#property version   "1.00"
//---
#property script_show_inputs
//---
/*  Продолжим изучение языка программирования MQL5. На этот раз мы напишем код скрипта,
    который будет устанавливать на текущем графике сразу по одному отложенному ордеру BuyStop
    и SellStop с фиксированным размером лота на некотором расстоянии от текущей цены.
    Если кто-то подзабыл, что это за ордера, то у нас всегда есть под рукой словарь терминов,
    написанный в скрипте New1.mq5, который поможет освежить память. Чтобы задавать входные
    параметры скрипта снова воспользуемся модификатором input. Мы это уже делали в предыдущем
    скрипте New5.mq5. Но, прежде всего, в шаблоне скрипта мы должны прописать свойство
    "script_show_inputs" (дословный перевод - показать входы скрипта), иначе мы не сможем
    менять входные параметры в момент его запуска. Итак, начнем!
*/

Tomorrow I'll try to write it all down as I promised earlier, in an accessible form for a 1st year pupil of programming school and post the full code of the script for everyone to see.

Regards, Vladimir.

 
MrBrooklin:

Just finished writing the code for a new script. Here's a description of it:

Tomorrow I'll try to write it all down as I promised earlier, in an accessible form for a 1st year pupil of programming school and post the full code of the script for everyone to see.

Best regards, Vladimir.

Here you can take an example - for a quick understanding

https://www.mql5.com/ru/code/30709

Grid
Grid
  • www.mql5.com
Описание настроек скрипта: FixedLot - объем лота каждого ордера. TakeProfit - тейк-профит каждого ордера. Стоп-лосс не используется. Добавить не трудно. Grid_step - шаг сетки в пунктах. Значение для брокеров с пятизначными котировками. N_orders - количество ордеров в одном направлении Distance - отступ в пунктах от текущей цены. Первые ордера в...
 
SanAlex:

Here you can take an example - for a quick understanding

https://www.mql5.com/ru/code/30709

Thank you for the example.

Respectfully, Vladimir.

 

Good evening to all and good mood!

I am pasting a new script New6.mq5 that helps you place one SellStop and one BuyStop pending order with a fixed lot size at a certain distance from the current price on the current chart. In this script, I tried to describe everything as I promised earlier, in a very clear form for a 1st grade programmer.

I used the information taken from the MQL5 Reference only when writing the script!

Sincerely, Vladimir.

//+------------------------------------------------------------------+
//|                                                         New6.mq5 |
//|                        Copyright 2020, MetaQuotes Software Corp. |
//|                                             https://www.mql5.com |
//+------------------------------------------------------------------+
#property copyright "Copyright 2020, MetaQuotes Software Corp."
#property link      "https://www.mql5.com"
#property version   "1.00"
//---
#property script_show_inputs
//---
/* Продолжим изучение языка программирования MQL5. На этот раз мы напишем код скрипта,
   который будет устанавливать на текущем графике сразу по одному отложенному ордеру Buy Stop
   и Sell Stop с фиксированным размером лота на некотором расстоянии от текущей цены.
   Если кто-то подзабыл, что это за ордера, то у нас всегда есть под рукой словарь терминов,
   написанный в скрипте New1.mq5, который поможет освежить память. Чтобы задавать входные
   параметры скрипта снова воспользуемся модификатором input. Мы это уже делали в предыдущем
   скрипте New5.mq5. Но, прежде всего, в шаблоне скрипта мы должны прописать свойство 
   "script_show_inputs" (дословный перевод - показать входы скрипта), иначе мы не сможем 
   изменять входные параметры в момент его запуска. Итак, начнем!*/

/* Сначала создадим для работы скрипта входные переменные Distance, Lots и Pending_magic.*/

input int    Distance=100;           //Отступ отложенного ордера от текущей цены
input double Lots=0.01;              //Фиксированный размер лота
input long   Pending_magic=86513;    //Магический номер ордера

//+------------------------------------------------------------------+
//| Script program start function                                    |
//+------------------------------------------------------------------+
/* Чтобы запустить скрипт в работу напишем функцию "Старт".*/
void OnStart()                                                    
  {
/* Далее. Для того, чтобы установить один или сразу несколько торговых ордеров сперва
   необходимо наладить взаимодействие между клиентским терминалом, который установлен
   на нашем компьютере и торговым сервером, который находится у форекс-дилера. 
   Проведение всех операций по установке торговых ордеров производится посредством торговых
   запросов. Сначала мы сделаем запрос на торговый сервер специальной предопределенной
   структурой MqlTradeRequest. Эта структура содержит все поля, необходимые для заключения 
   торговых сделок. Пишем код для торгового запроса:*/
   MqlTradeRequest request={0};
/* request={0} - здесь мы создаем переменную, в которой будут находится все сведения о запросе.*/

/* После того, как торговый сервер обработает торговый запрос, мы получим от него ответ. 
   Результат обработки торгового запроса представлен структурой MqlTradeResult.
   Пишем код для получения результата обработки торгового запроса:*/
   MqlTradeResult result={0};
/* result={0} - здесь мы создаем переменную, в которой будут находится все сведения о результатах запроса.*/

/* Далее необходимо указать все параметры необходимые для установки отложенного ордера. Во-первых, в коде
   скрипта запишем request.action, т.к. мы сначала запрашиваем действие, а потом указываем какое именно
   действие нужно совершить: TRADE_ACTION_PENDING - установить торговый ордер на совершение сделки
   при определенных условиях, т.е. установить отложенный ордер.*/
   request.action=TRADE_ACTION_PENDING;

/* Во-вторых, в запросе укажем символ текущего графика.*/
   request.symbol=Symbol();

/* В-третьих, в запросе укажем объём фиксированного лота, который прописан во входных параметрах скрипта.*/
   request.volume=Lots;

/* В-четвёртых, в запросе укажем допустимое отклонение от цены.*/
   request.deviation=2;

/* В-пятых, в запросе укажем магический номер ордера, который прописан во входных параметрах скрипта.*/
   request.magic=Pending_magic;

/* Теперь нужно создать переменную price (цена срабатывания ордера) и присвоить ей тип значения,
   имеющего дробную часть, т.е. double.*/
   double price;

/* Дальше создадим переменную point и сразу же присвоим ей возврат соответствующего свойства
   SymbolInfoDouble для указанного символа _Symbol, а именно SYMBOL_POINT (т.е. размер одного пункта),
   при этом добавим в начале кода, что тип значения имеет дробную часть, т.е. double.*/
   double point=SymbolInfoDouble(_Symbol,SYMBOL_POINT);

/* На следующем шаге создадим переменную digits и сразу же присвоим ей возврат соответствующего свойства
   SymbolInfoInteger для указанного символа _Symbol, а именно SYMBOL_DIGITS (т.е. количество знаков после
   запятой), при этом добавим в начале кода, что тип значения будет int. Перед SymbolInfoInteger также нужно
   добавить тип значения int, т.к. в противном случае после компиляции скрипта появится предупреждение:
   "возможная потеря данных из-за преобразования типа".*/
   int digits=(int)SymbolInfoInteger(_Symbol,SYMBOL_DIGITS);

/* Далее:
   1. отправляем на торговый сервер запрос request.type типа ордера ORDER_TYPE_BUY_STOP (отложенный 
   ордер Buy Stop);
   2. присваиваем переменной price возврат соответствующего свойства SymbolInfoDouble для указанного
   символа Symbol(), а именно SYMBOL_ASK (лучшее предложение на покупку), прибавив отступ (Distance)
   умноженный на размер одного пункта (point).
   3. отправляем на торговый сервер ещё один запрос request.price для нормализации цены NormalizeDouble
   до необходимого количества знаков после запятой.*/
     {
      request.type=ORDER_TYPE_BUY_STOP;
      price=SymbolInfoDouble(Symbol(),SYMBOL_ASK)+Distance*point;
      request.price=NormalizeDouble(price,digits);
     }

/* Движемся дальше. После отправки запросов на торговый сервер нам необходимо узнать о том, что был
   установлен отложенный ордер или нет. Для это применим функцию OrderSend, которая предназначена для
   совершения торговых операций через отправку запросов на торговый сервер. Если отправить запрос
   не удалось !OrderSend (восклицательный знак перед любой функцией означает отрицательный результат её
   выполнения), то тогда выводим сообщение с кодом ошибки в заданном формате: "OrderSend error %d"
   и GetLastError(). Давайте разберемся, что такое "OrderSend error %d" и что такое GetLastError().
   Обратите внимание на то, что "OrderSend error %d" взят в двойные кавычки. Это означает, что будет
   выведен текст с дословным переводом "Ошибка отправки заказа %d". Теперь давайте поймём, что означает
   %d. В Справочнике MQL5 в разделе PrintFormat находим: "Если за строкой формата следуют еще параметры,
   то эта строка должна содержать спецификации формата, определяющие формат вывода этих параметров.
   Спецификация формата всегда начинается с символа знака процента (%)". А что такое d? В том же разделе
   чуть ниже находим: "Тип d - Знаковое десятичное целое". С этим разобрались, осталось понять, что такое
   GetLastError(). Снова ищем в справочнике: "GetLastError() возвращает содержимое системной переменной 
   _LastError, т.е. той переменной, в которой хранится значение последней ошибки, произошедшей во время 
   исполнения mql5-программы".*/
   if(!OrderSend(request,result))
      PrintFormat("OrderSend error %d",GetLastError());

/* Выше мы написали код о том, если не удалось отправить запрос !OrderSend. Сейчас мы напишем код о том, 
   что выведем в сообщении о результатах операции при удачной отправке запроса. Воспользуемся всё той же
   функцией PrintFormat. После открытия скобки в двойных кавычках перчисляем всё, что мы хотим вывести в
   сообщении: 1. retcode (код возврата торгового сервера); 2. deal (сделка); 3. order (ордер) и сразу
   задаем каждому значению тип параметра: %u - int и %I64u - ulong. Кроме того, мы должны указать
   результат ответа торгового сервера по result.retcode (результат кода возврата торгового сервера),
   result.deal (результат сделки) и result.order (результат ордера).*/
   PrintFormat("retcode=%u  deal=%I64u  order=%I64u",result.retcode,result.deal,result.order);

/* Снова:
   1. отправляем на торговый сервер запрос request.type типа ордера ORDER_TYPE_SELL_STOP (отложенный 
   ордер Sell Stop);
   2. присваиваем переменной price возврат соответствующего свойства SymbolInfoDouble для указанного
   символа Symbol(), а именно SYMBOL_BID (лучшее предложение на продажу), вычтя отступ (Distance)
   умноженный на размер одного пункта (point).
   3. отправляем на торговый сервер ещё один запрос request.price для нормализации цены NormalizeDouble
   до необходимого количества знаков после запятой.*/
     {
      request.type=ORDER_TYPE_SELL_STOP; 
      price=SymbolInfoDouble(Symbol(),SYMBOL_BID)-Distance*point;
      request.price=NormalizeDouble(price,digits);
     }

/* Опять после отправки запросов на торговый сервер нам необходимо узнать о том, что был установлен
   отложенный ордер или нет. Для это применим функцию OrderSend, которая предназначена для
   совершения торговых операций через отправку запросов на торговый сервер. Если отправить запрос
   не удалось !OrderSend (восклицательный знак перед любой функцией означает отрицательный результат её
   выполнения), то тогда выводим сообщение с кодом ошибки в заданном формате: "OrderSend error %d"
   и GetLastError().*/
   if(!OrderSend(request,result))
      PrintFormat("OrderSend error %d",GetLastError());

/* Ранее мы уже написали код о том, если не удалось отправить запрос !OrderSend. Сейчас мы напишем код о том, 
   что выведем в сообщении о результатах операции при удачной отправке запроса. Воспользуемся всё той же
   функцией PrintFormat. После открытия скобки в двойных кавычках перчисляем всё, что мы хотим вывести в
   сообщении: 1. retcode (код возврата торгового сервера); 2. deal (сделка); 3. order (ордер) и сразу
   задаем каждому значению тип параметра: %u - int и %I64u - ulong. Кроме того, мы должны указать
   результат ответа торгового сервера по result.retcode (результат кода возврата торгового сервера),
   result.deal (результат сделки) и result.order (результат ордера).*/
   PrintFormat("retcode=%u  deal=%I64u  order=%I64u",result.retcode,result.deal,result.order);
  }
  
/* Всё! Наш новый скрипт готов. Компилируем и запускаем скрипт. Как компилировать и запускать скрипт мы 
   уже узнали, когда создавали скрипт New2.mq5.*/  
  
//+------------------------------------------------------------------+
 

In the future, according to the self-study plan, the task is to modify the script step by step, namely:

  1. add Stop Loss and Take Profit;
  2. add trailing;
  3. add maximal risk;
  4. expand choice of pending orders.
Sincerely, Vladimir.
Reason: