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

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

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

661

GlobalVariableDel

Удаляет глобальную переменную клиентского терминала.

bool GlobalVariableDel(

string name // имя

);

Параметры

name

[in] Имя глобальной переменной.

Возвращаемое значение

При успешном удалении функция возвращает true, иначе false. Чтобы получить информацию об

ошибке, необходимо вызвать функцию GetLastError().

Примечание

Глобальные переменные существуют в клиентском терминале 4 недели с момента последнего

обращения, после этого автоматически уничтожаются.

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

662

GlobalVariableGet

Возвращает значение существующей глобальной переменной клиентского терминала. Существует

2 варианта функции.

1. Непосредственно возвращает значение свойства.

double GlobalVariableGet(

string name // имя

);

2. Возвращает true или false в зависимости от успешности выполнения функции. В случае успеха

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

передаваемую по ссылке вторым параметром.

bool GlobalVariableGet(

string name, // имя

double&double_var // сюда примем значение глобальной переменной

);

Параметры

name

[in] Имя глобальной переменной.

double_var

[out] Переменная типа double, принимающая значение, хранящееся в глобальной переменной

клиентского терминала.

Возвращаемое значение

Значение существующей глобальной переменной или 0 в случае ошибки. Чтобы получить

информацию об ошибке, необходимо вызвать функцию GetLastError().

Примечание

Глобальные переменные существуют в клиентском терминале 4 недели с момента последнего

обращения, после этого автоматически уничтожаются.

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

663

GlobalVariableName

Возвращает имя глобальной переменной по порядковому номеру.

string GlobalVariableName(

int index // номер в списке глобальных переменных

);

Параметры

index

[in] Порядковый номер в списке глобальных переменных. Должен быть большим или равным

0 и меньшим, чем GlobalVariablesTotal() .

Возвращаемое значение

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

получить информацию об ошибке необходимо вызвать функцию функцию GetLastError().

Примечание

Глобальные переменные существуют в клиентском терминале 4 недели с момента последнего

обращения, после этого автоматически уничтожаются.

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

664

GlobalVariableSet

Устанавливает новое значение глобальной переменной. Если переменная не существует, то

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

datetime GlobalVariableSet(

string name, // имя

double value // устанавлимое значение

);

Параметры

name

[in] Имя глобальной переменной.

value

[in] Новое числовое значение.

Возвращаемое значение

При успешном выполнении функция возвращает время последнего доступа, иначе 0. Чтобы

получить информацию об ошибке, необходимо вызвать функцию GetLastError().

Примечание

Глобальные переменные существуют в клиентском терминале 4 недели с момента последнего

обращения, после этого автоматически уничтожаются.

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

665

GlobalVariablesFlush

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

void GlobalVariablesFlush();

Возвращаемое значение

Нет возвращаемого значения.

Примечание

Терминал сам записывает все глобальные переменные при окончании работы, но при внезапном

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

управлять процессом сохранения глобальных переменных на случай нештатных ситуаций.

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

666

GlobalVariableTemp

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

существует, то система создает новую временную глобальную переменную.

bool GlobalVariableTemp(

string name // имя

);

Параметры

name

[in] Имя временной глобальной переменной.

Возвращаемое значение

При успешном выполнении функция возвращает true, иначе false. Чтобы получить информацию

об ошибке, необходимо вызвать функцию GetLastError().

Примечание

Временные глобальные переменные существуют только во время работы клиентского

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

операции GlobalVariablesFlush() временные глобальные переменные на диск не записываются.

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

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

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

667

GlobalVariableSetOnCondition

Устанавливает новое значение существующей глобальной переменной, если текущее значение

переменной равно значению третьего параметра check_value. Если переменной не существует,

функция сгенерирует ошибку ERR_GLOBALVARIABLE_NOT_FOUND (4501) и вернет false.

bool GlobalVariableSetOnCondition(

string name, // имя

double value, // значение при выполнении условия

double check_value // проверяемое условие

);

Параметры

name

[in] Имя глобальной переменной.

value

[in] Новое значение.

check_value

[in] Значение для проверки текущего значения глобальной переменной.

Возвращаемое значение

При успешном выполнении функция возвращает true, иначе false. Для того, чтобы получить

информацию об ошибке, необходимо вызвать функцию GetLastError(). Если текущее значение

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

Примечание

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

использована для организации мьютекса при взаимодействии нескольких одновременно

работающих экспертов в пределах одного клиентского терминала.

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

668

GlobalVariablesDeleteAll

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

int GlobalVariablesDeleteAll(

string prefix_name=NULL, // все глобальные переменные, чьи имена начинаются с префикса

datetime  limit_data=0 // все глобальные переменные, которые изменялись ранее ранее указанной даты

);

Параметры

prefix_name=NULL

[in] Префикс имени удаляемых глобальных переменных. Если указан префикс NULL либо

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

соответствующие критерию удаления по дате

limit_data=0

[in] Дата для отбора глобальных переменных по времени последней модификации.

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

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

критерию (по префиксу).

Возвращаемое значение

Количество удаленных переменных.

Примечание

Если оба параметра равны нулю (prefix_name=NULL и limit_data=0), то удаляются все

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

переменные, соответствующие одновременно каждому из указанных параметров.

Глобальные переменные существуют в клиентском терминале 4 недели с момента последнего

обращения, после этого автоматически уничтожаются.

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

669

GlobalVariablesTotal

Возвращает общее количество глобальных переменных клиентского терминала.

int GlobalVariablesTotal();

Возвращаемое значение

Количество глобальных переменных.

Примечание

Глобальные переменные существуют в клиентском терминале 4 недели с момента последнего

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

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

Файловые операции

670

Файловые операции

Группа функций для работы с файлами.

Из соображений безопасности в языке MQL5 строго контролируется работа с файлами. Файлы, с

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

пределами файловой "песочницы".

Существует два каталога (с подкаталогами), в которых могут располагаться рабочие файлы:

каталог_терминала\MQL5\FILES\ (выберите для просмотра в терминале пункт меню

"Файл"-"Открыть каталог данных");

общая папка всех установленных на компьютере терминалов – обычно расположена в каталоге

C:\Documents and Settings\All Users\Application Data\MetaQuotes\Terminal\Common\ .

Программным путем можно получить наименования этих каталогов с помощью функции

TerminalInfoString(), используя перечисления ENUM_TERMINAL_INFO_STRING:

//--- Папка, в которой хранятся данные терминала

string terminal_data_path=TerminalInfoString(TERMINAL_DATA_PATH);

//--- Общая папка всех клиентских терминалов

string common_data_path=TerminalInfoString(TERMINAL_COMMONDATA_PATH);

Работа с файлами из других каталогов пресекается.

Функция

Действие

FileFindFirst

Начинает перебор файлов в соответствующей

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

фильтром

FileFindNext

Продолжает поиск, начатый функцией

FileFindFirst()

FileFindClose

Закрывает хэндл поиска

FileOpen

Открывает файл с указанным именем и

указанными флагам

FileDelete

Удаляет указанный файл

FileFlush

Сброс на диск всех данных, оставшихся в

файловом буфере ввода-вывода

FileIsEnding

Определяет конец файла в процессе чтения

FileIsLineEnding

Определяет конец строки в текстовом файле

в процессе чтения

FileClose

Закрывает ранее открытый файл

FileIsExist

Проверяет существование файла

FileCopy

Копирует исходный файл из локальной или

общей папки в другой файл

FileMove

Перемещает или переименовывает файл