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

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

Основы языка

141

Переменные

Объявление переменных

Переменные должны быть объявлены перед их использованием. Для идентификации переменных

используются уникальные имена. Описания переменных используются для их определения и

объявления типов. Описание не является оператором.

Простыми типами являются:

char, short, int, long, uchar, ushort, uint, ulong – целые числа;

color – целое число, представляющее RGB-цвет;

datetime – дата и время, беззнаковое целое число, содержащее количество секунд, прошедших

с 0 часов 1 января 1970 года;

bool – логические значения true и false;

double – числа двойной точности с плавающей точкой;

float – числа одинарной точности с плавающей точкой;

string – символьные строки.

Примеры:

string szInfoBox;

int nOrders;

double dSymbolPrice;

bool bLog;

datetime tBegin_Data = D'2004.01.01 00:00';

color cModify_Color = C'0x44,0xB9,0xE6';

Сложные или составные типы:

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

struct MyTime

{

int hour; // 0-23

int minute; // 0-59

int second; // 0-59

};

...

MyTime strTime; // переменная типа объявленной ранее структуры MyTime

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

Массивы

Массив - это индексированная совокупность однотипных данных:

int a[50]; // Одномерный массив из 50 целых чисел.

double m[7][50]; // Двухмерный массив из семи массивов,

// каждый из которых состоит из 50 чисел.

Основы языка

142

MyTime t[100]; // массив содержащий элементы типа MyTime

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

массивы. Нумерация элементов массива начинается с 0. Последний элемент одномерного массива

имеет номер на 1 меньший, чем размер массива, то есть обращение к последнему элементу

массива из 50 целых чисел будет выглядеть как a[49]. То же самое относится и к многомерным

массивам – индексация одного измерения производится от 0 до размер измерения-1. Последний

элемент двумерного массива из примера будет выглядеть как m[6][49].

Статические массивы не могут быть представлены в виде таймсерий, то есть к ним не применима

функция ArraySetAsSeries(), которая устанавливает доступ к элементам массива от конца массива

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

динамического массива.

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

выполнение программы будет остановлено.

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

Спецификаторы доступа указывают компилятору каким образом можно осуществлять доступ к

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

Спецификатор const объявляет переменную константой, и не позволяет изменять значение этой

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

переменной при ее объявлении. Спецификатор const неприменим к членам структур и классов.

Пример

int OnCalculate (const int rates_total, // размер массива price[]

const int prev_calculated, // обработано баров на предыдущем вызове

const int begin, // откуда начинаются значимые данные

const double& price[] // массив для расчета

);

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

public – разрешает ничем неограниченный доступ к переменной или методу класса;

protected – разрешает доступ со стороны методов данного класса, а также со стороны методов

публичнонаследуемых классов. Иной доступ невозможен;

private – разрешает доступ к переменным и методам класса только из методов данного класса.

virtual – применим только к методам класса (но не к методам структур) и сообщает

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

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

Существуют три класса памяти: static, input и extern. Эти модификаторы класса памяти явно

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

области памяти, называемой глобальным пулом. При этом данные модификаторы указывают на

особую обработку данных переменных.

Если переменная, объявленная на локальном уровне, не является статической, то распределение

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

Основы языка

143

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

за пределы области видимости блока, в котором массив объявлен.

Смотри также

Типы данных, Инкапсуляция и расширяемость типов, Инициализация переменных, Область

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

Основы языка

144

Локальные переменные

Переменная, объявленная внутри какой-либо функции, является локальной. Область видимости

локальной переменной ограничена пределами функции, внутри которой она объявлена.

Локальная переменная может быть проинициализирована при помощи любого выражения.

Инициализация локальной переменной производится каждый раз при вызове соответствующей

функции. Локальные переменные располагаются во временной области памяти соответствующей

функции.

Пример:

int somefunc()

{

int ret_code=0;

...

return(ret_code);

}

Область действия (или областьвидимости) переменной – это часть программы, в которой на

переменную можно сослаться. Переменные, объявленные внутри блока (на внутреннем уровне),

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

заканчивается конечной правой фигурной скобкой.

Локальные переменные, объявленные в начале функции, имеют область действия блок так же,

как и параметрыфункции, являющиеся локальными переменными. Любой блок может содержать

объявления переменных. Если блоки вложены и идентификатор во внешнем блоке имеет такое же

имя, как идентификатор во внутреннем блоке, идентификатор внешнего блока "невидим" (скрыт)

до момента завершения работы внутреннего блока.

Пример:

void OnStart()

{

//---

int i=5; // локальная переменная функции

{

int i=10; // переменная функции

Print("В блоке i = ",i); // результат i = 10;

}

Print("Вне блока i = ",i); // результат i = 5;

}

Это означает, что пока выполняется внутренний блок, он видит значения своих собственных

локальных идентификаторов, а не значения идентификаторов с идентичными именами в

охватывающем блоке.

Пример:

Основы языка

145

void OnStart()

{

//---

int i=5; // локальная переменная функции

for(int i=0;i<3;i++)

Print("Внутри for i = ",i);

Print("Вне блока i = ",i);

}

/* Результат выполнения

Внутри for i = 0

Внутри for i = 1

Внутри for i = 2

Вне блока i = 5

Локальные переменные, объявленные как static, имеют областью действия блок, несмотря на то,

что они существуют с самого начала выполнения программы.

Смотри также

Типы данных, Инкапсуляция и расширяемость типов, Инициализация переменных, Область

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

Основы языка

146

Формальные параметры

Передаваемые в функцию параметры являются локальными. Областью видимости является блок

функции. Формальные параметры должны отличаться по именам от внешних переменных и

локальных переменных, определенных внутри функции. В блоке функции формальным

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

с модификатором const, то его значение не может быть изменено внутри функции.

Пример:

void func(const int & x[], double y, bool z)

{

if(y>0.0 && !z)

Print(x[0]);

...

}

Формальные параметры могут быть проинициализированы константами. В этом случае

инициализирующее значение считается значением по умолчанию. Параметры, следующие за

проинициализированным параметром, должны быть тоже проинициализированы.

Пример:

void func(int x, double y = 0.0, bool z = true)

{

...

}

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

подставлены значения по умолчанию.

Пример:

func(123, 0.5);

Параметры простыхтипов передаются по значению, то есть изменения соответствующей

локальнойпеременной такого типа внутри вызываемой функции никак не отразится в

вызывающей функции. Массивы любых типов и данные типа структур всегда передаются по

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

этих типов должны быть объявлены с ключевым словом const.

Существует возможность передавать по ссылке и параметры простых типов . В этом случае

модификация таких параметров отразится на соответствующих переменных в вызываемой

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

после типа данных необходимо поставить модификатор &.

Пример:

void func(int& x, double& y, double & z[])

{

double calculated_tp;

...

Основы языка

147

for(int i=0; i<OrdersTotal(); i++)

{

if(i==ArraySize(z)) break;

if(OrderSelect(i)==false) break;

z[i]=OrderOpenPrice();

}

x=i;

y=calculated_tp;

}

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

В функцию нельзя передать больше 64 параметров.

Смотри также

Input переменные, Типы данных, Инкапсуляция и расширяемость типов, Инициализация

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

Основы языка

148

Статические переменные

Класс памяти static определяет статическую переменную. Модификатор static указывается перед

типом данных.

Пример:

int somefunc()

{

static int flag=10;

...

return(flag);

}

Статическая переменная может быть проинициализирована соответствующей ее типу константой

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

проинициализирована любым выражением.

Статические переменные существуют с момента выполнения программы и инициализируются

однократно перед вызовом специализированной функции OnInit(). Если начальные значения не

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

Локальныепеременные, объявленные с ключевым словом static сохраняют свои значения в

течение всего временисуществования функции. При каждом следующем вызове функции такие

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

Любые переменные в блоке, кроме формальныхпараметров функции, могут быть определены как

статические. Если переменная, объявленная на локальном уровне не является статической, то

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

Пример:

int Counter()

{

static int count;

count++;

if(count%100==0) Print("Функция Counter была вызвана уже ",count," раз");

return count;

}

void OnStart()

{

//---

int c=345;

for(int i=0;i<1000;i++)

{

int c=Counter();

}

Print("c = ",c);

}

Смотри также

Типы данных, Инкапсуляция и расширяемость типов, Инициализация переменных, Область

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

Основы языка

149

Глобальные переменные

Глобальные переменные создаются путем размещения их объявлений вне описания какой-либо

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

локальны ни в каком блоке.

Пример:

int GlobalFlag=10; // глобальная переменная

int OnStart()

{

...

}

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

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

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

соответствующей ее типу константой либо константным выражением.

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

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

Замечание: не следует путать переменные, объявленные на глобальном уровне, с глобальными

переменными клиентского терминала, доступ к которым осуществляется при помощи функций

GlobalVariable...().

Смотри также

Типы данных, Инкапсуляция и расширяемость типов, Инициализация переменных, Область

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

Основы языка

150

Input переменные

Класс памяти input определяет внешнюю переменную. Модификатор input указывается перед

типом данных. Изменять значение переменной с модификатором input внутри mql5-программы

нельзя, такие переменные доступны только для чтения. Изменять значения input-переменных

может только пользователь из окна свойств программы.

Пример:

//--- input parameters

input int MA_Period=13;

input int MA_Shift=0;

input ENUM_MA_METHOD MA_Method=MODE_SMMA;

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

программы.

Существует возможность задать иной способ отображения имен входных параметров на закладке

"Inputs". Для этого используется строчный комментарий, который должен располагаться после

описания входного параметра в той же строке. Таким образом, входным параметрам можно

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

Пример:

//--- input parameters

input int InpMAPeriod=13; // Smoothing period

input int InpMAShift=0; // Line horizontal shift

input ENUM_MA_METHOD InpMAMethod=MODE_SMMA; // Smoothing method