Справочник по языку программирования MQL5

Подождите немного. Документ загружается.

Основы языка

Синтаксис

Синтаксически язык программирования торговых стратегий MQL5 очень похож на язык

программирования С++, за исключением некоторых возможностей:

отсутствует адресная арифметика;

отсутствует оператор goto;

нельзя объявить анонимное перечисление;

конструкторы классов и структур не могут иметь параметров;

нет множественного наследования.

Смотри также

Перечисления, Структуры и классы, Наследование

Основы языка

Комментарии

Многострочные комментарии начинаются парой символов /* и заканчиваются парой */. Данные

комментарии не могут быть вложенными. Однострочные комментарии начинаются парой символов

//, заканчиваются символом новой строки и могут быть вложены в многострочные комментарии.

Комментарии разрешены везде, где возможны пробелы, и допускают любое число пробелов.

Примеры:

//--- Однострочный комментарий

/* Многостроч-

ный // Вложенный однострочный комментарий

комментарий

Основы языка

Идентификаторы

Идентификаторы используются в качестве имен для переменных и функций. Длина

идентификатора не может превышать 63 знака.

Допустимые символы при написании идентификатора: цифры 0-9, латинские прописные и

строчные буквы а-z и А-Z, распознаваемые как разные символы, символ подчеркивания (_).

Первый символ не может быть цифрой.

Идентификатор не должен совпадать с зарезервированным словом.

Примеры:

NAME1 namel Total_5 Paper

Смотри также

Переменные, Функции

Основы языка

Зарезервированные слова

Перечисленные ниже идентификаторы фиксируются как зарезервированные слова, каждому из

которых соответствует определенное действие, и в другом смысле не могут использоваться:

Типы данных

bool

enum

struct

char

float

uchar

class

int

uint

color

long

ulong

datetime

short

ushort

double

string

void

Спецификаторы доступа

const

private

protected

public

virtual

Классы памяти

extern

input

static

Операторы

break

return

case

else

sizeof

continue

for

switch

default

while

delete

new

Прочие

false

#define

#property

this

#import

true

#include

Основы языка

Типы данных

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

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

типа. Ценовые данные имеют тип двойной точности с плавающей точкой. Это связано с тем, что в

языке MQL5 не предусмотрено специального типа для ценовых данных.

Данные разного типа обрабатываются с разной скоростью. Целочисленные данные

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

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

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

Дольше всего обрабатываются строковые данные. Это связано с динамическим распределением-

перераспределением оперативной памяти компьютера.

Основные типы данных:

целые (char, short, int, long, uchar, ushort, uint, ulong)

логические (bool)

литералы (ushort)

строки (string)

с плавающей точкой (double, float)

цвет (color)

дата и время (datetime)

перечисления (enum)

Сложные типы данных:

структуры;

классы.

В терминах OOП сложные типы данных называются абстрактными типами данных.

Типы color и datetime имеют смысл только для удобства представления и ввода параметров,

задаваемых извне - из таблицы свойств советника или пользовательского индикатора (вкладка "

Inputs"). Данные типов color и datetime представляются в виде целых чисел. Целые типы вместе с

типами с плавающей точкой называются арифметическими (числовыми) типами.

В выражениях используется неявное приведениетипов, если не указано явное приведение.

Смотри также

Приведение типов

Основы языка

Целые типы

Целые типы представлены в языке MQL5 одиннадцатью видами. Некоторые из типов могут

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

иметь ввиду правила преобразования типов.

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

каждого типа указан соответствующий тип в языке программирования C++.

Тип

Размер в

байтах

Минимальное

значение

Максимальное

значение

Аналог в языке

С++

char

-128

127

char

uchar

255

unsigned char,

BYTE

bool

0(false)

1(true)

bool

short

-32 768

32 767

short, wchar_t

ushort

65 535

unsigned short,

WORD

int

- 2 147 483 648

2 147 483 647

int

uint

4 294 967 295

unsigned int,

DWORD

color

-1

16 777 215

int, COLORREF

long

-9 223 372 036

854 775 808

9 223 372 036

854 775 807

__int64

ulong

18 446 744 073

709 551 615

unsigned __int64

datetime

0 (1970.01.01

0:00:00)

32 535 244 799

(3000.12.31

23:59:59)

__time64_t

Значения целых типов можно также представлять в виде числовых констант, цветовых

литералов, литералов даты-времени, символьных констант и перечислений.

Смотри также

Преобразование данных, Константы числовых типов

Основы языка

Типы char, short, int и long

char

Целый тип char занимает в памяти 1 байт (8 бит) и позволяет выразить в двоичной системе

счисления 2^8 значений=256. Тип char может содержать как положительные, так и отрицательные

значения. Диапазон изменения значений составляет от -128 до 127.

uchar

Целый тип uchar также занимает в памяти 1 байт, как и тип char, но в отличие от него, uchar

предназначен только для положительных значений. Минимальное значение равно нулю,

максимальное значение равно 255. Первая буква u в названии типа uchar является сокращением

слова unsigned (беззнаковый).

short

Целый тип short имеет размер 2 байта(16 бит) и, соответственно, позволяет выразить множество

значений равное 2 в степени 16: 2^16=65 536. Так как тип short является знаковым и содержит

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

768 и 32 767.

ushort

Беззнаковым типом short является тип ushort, который также имеет размер 2 байта. Минимальное

значение равно 0, максимальное значение 65 535.

int

Целый тип int имеет размер 4 байта (32 бита). Минимальное значение -2 147 483 648,

максимальное значение 2 147 483 647.

uint

Беззнаковый целый тип uint занимает в памяти 4 байта и позволяет выражать целочисленные

значения от 0 до 4 294 967 295.

long

Целый тип long имеет размер 8 байт (64 бита). Минимальное значение -9 223 372 036 854 775 808,

максимальное значение 9 223 372 036 854 775 807.

ulong

Целый тип ulong также занимает 8 байт и позволяет хранить значения от 0 до 18 446 744 073 709

551 615.

Примеры:

Основы языка

char ch=12;

short sh=-5000;

int in=2445777;

Так как беззнаковые целые типы не предназначены для хранения отрицательных значений, то

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

такой невинный скрипт приведет к бесконечному циклу:

//--- бесконечный цикл

void OnStart()

{

uchar u_ch;

for(char ch=-128;ch<128;ch++)

{

u_ch=ch;

Print("ch = ",ch," u_ch = ",u_ch);

}

Правильно будет так:

//--- правильный вариант

void OnStart()

{

uchar u_ch;

for(char ch=-128;ch<=127;ch++)

{

u_ch=ch;

Print("ch = ",ch," u_ch = ",u_ch);

if(ch==127) break;

}

Результат:

ch= -128 u_ch= 128

ch= -127 u_ch= 129

ch= -126 u_ch= 130

ch= -125 u_ch= 131

ch= -124 u_ch= 132

ch= -123 u_ch= 133

ch= -122 u_ch= 134

ch= -121 u_ch= 135

ch= -120 u_ch= 136

ch= -119 u_ch= 137

ch= -118 u_ch= 138

ch= -117 u_ch= 139

ch= -116 u_ch= 140

ch= -115 u_ch= 141

ch= -114 u_ch= 142

ch= -113 u_ch= 143

ch= -112 u_ch= 144

ch= -111 u_ch= 145

...

Примеры:

Основы языка

//--- отрицательные значения нельзя хранить в беззнаковых типах

uchar u_ch=-120;

ushort u_sh=-5000;

uint u_in=-401280;

Шестнадцатеричные: цифры 0-9, буквы а-f или А-F для значений 10-15; начинаются с 0х или 0Х.

Примеры:

0x0A, 0x12, 0X12, 0x2f, 0xA3, 0Xa3, 0X7C7

Смотри также

Приведение типов

Основы языка

Символьные константы

Символы, как элемент строки, в MQL5 - это индексы в наборе символов Unicode. Они являются 16-

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

манипулировать целочисленными операциями, такими как сложение и вычитание.

Любой одиночный символ, заключенный в одинарные кавычки, или шестнадцатеричный ASCII-код

символа в виде '\x10' является символьной константой и имеет тип ushort. Например, запись вида

'0' представляет из себя числовое значение 30, соответствующее индексу, по которому в таблице

символов располагается символ ноль.

Пример:

void OnStart()

{

//--- определим символьные константы

int symbol_0='0';

int symbol_9=symbol_0+9; // получим символ '9'

//--- выведем значения констант

printf("В десятичном виде: symbol_0 = %d, symbol_9 = %d",symbol_0,symbol_9);

printf("В шестнадцетеричном виде: symbol_0 = 0x%x, symbol_9 = 0x%x",symbol_0,symbol_9);

//--- заведем константы в строку

string test="";

StringSetCharacter(test,0,symbol_0);

StringSetCharacter(test,1,symbol_9);

//--- а вот как они выглядят в строке

Print(test);

}

Обратная косая черта является управляющим символом для компилятора при разборе

константных строк и символьных констант в исходном тексте программы. Некоторые символы,

например, одинарные кавычки ('), двойные кавычки ("), обратная косая черта (\) и управляющие

символы можно представлять комбинацией символов, начинающейся с обратной косой черты(\), в

соответствии с приводимой ниже таблицей:

Название символа

Мнемокод или

изображение

Запись в MQL5

Числовое

значение

новая строка

(перевод строки)

'\n'

горизонтальная

табуляция

'\t'

возврат каретки

'\r'

обратная косая черта

'\\'

одинарная кавычка

'\''

двойная кавычка

'\"'

шестнадцатеричный

код

hhhh

'\xhhhh'

от 1до 4

шестнадцатеричных

знаков