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

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

Торговые функции

651

HistoryDealsTotal

Возвращает количество сделок в истории. Перед вызовом функции HistoryDealsTotal() необходимо

получить историю сделок и ордеров с помощью функции HistorySelect() или HistorySelectByPosition

().

int HistoryDealsTotal();

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

Значение типа int.

Примечание

Не следует путать между собой ордера, сделки и позиции. Каждая сделка является

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

одной или нескольких сделок.

Смотри также

HistorySelect(), HistoryDealGetTicket(), Свойства сделок

Торговые функции

652

HistoryDealGetTicket

Выбирает сделку для дальнейшей обработки и возвращает тикет сделки в истории. Перед

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

помощью функции HistorySelect() или HistorySelectByPosition().

ulong HistoryDealGetTicket(

int index // номер сделки

);

Параметры

index

[in] Номер сделки в списке сделок.

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

Значение типа ulong.

Примечание

Не следует путать между собой ордера, сделки и позиции. Каждая сделка является

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

одной или нескольких сделок.

Пример:

Торговые функции

653

void OnStart()

{

ulong deal_ticket; // тикет сделки

ulong order_ticket; // тикет ордера,по которому была совершена сделка

datetime transaction_time; // время совершения сделки

long deal_type ; // тип торговой операции

long position_ID; // идентификатор позиции

string deal_description; // описание операции

double volume; // объем операции

string symbol; // по какому символу была сделка

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

datetime from_date=0; // с самого начала

datetime to_date=TimeCurrent();// по текущий момент

//--- запросим историрю сделок в указанном интервале

HistorySelect(from_date,to_date);

//--- общее количество в списке сделок

int deals=HistoryDealsTotal();

//--- теперь обработаем каждую сделку

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

{

deal_ticket= HistoryDealGetTicket(i);

volume= HistoryDealGetDouble(deal_ticket,DEAL_VOLUME);

transaction_time=(datetime)HistoryDealGetInteger(deal_ticket,DEAL_TIME);

order_ticket= HistoryDealGetInteger(deal_ticket,DEAL_ORDER);

deal_type= HistoryDealGetInteger(deal_ticket,DEAL_TYPE);

symbol= HistoryDealGetString(deal_ticket,DEAL_SYMBOL);

position_ID= HistoryDealGetInteger(deal_ticket,DEAL_POSITION_ID);

deal_description= GetDealDescription(deal_type,volume,symbol,order_ticket,position_ID);

//--- сделаем красивое форматирование для номера сделки

string print_index=StringFormat("% 3d",i);

//--- выведем информацию по сделке

Print(print_index+": deal #",deal_ticket," at ",transaction_time,deal_description);

}

//+------------------------------------------------------------------+

//| возвращает строковое описание операции |

//+------------------------------------------------------------------+

string GetDealDescription(long deal_type,double volume,string symbol,long ticket,long pos_ID)

{

string descr;

//---

switch(deal_type)

{

case DEAL_TYPE_BALANCE: return ("balance");

case DEAL_TYPE_CREDIT: return ("credit");

case DEAL_TYPE_CHARGE: return ("charge");

case DEAL_TYPE_CORRECTION: return ("correction");

case DEAL_TYPE_BUY: descr="buy"; break;

case DEAL_TYPE_SELL: descr="sell"; break;

}

descr=StringFormat("%s %G %s (order #%d, position ID %d)",

descr, // текущее описание

volume, // объем сделки

symbol, // инструмент сделки

ticket, // тикет ордера,вызвавшего сделку

pos_ID // ID позиции, в которой участвовала сделка

);

return(descr);

//---

}

Торговые функции

654

Смотри также

HistorySelect(), HistoryDealsTotal(), HistoryDealSelect(), Свойства сделок

Торговые функции

655

HistoryDealGetDouble

Возвращает запрошенное свойство сделки. Свойство сделки должно быть типа double. Существует

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

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

double HistoryDealGetDouble(

ulong ticket_number, // тикет

ENUM_DEAL_PROPERTY_DOUBLE property_id // идентификатор свойства

);

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

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

параметром.

bool HistoryDealGetDouble(

ulong ticket_number, // тикет

ENUM_DEAL_PROPERTY_DOUBLE property_id, // идентификатор свойства

double& double_var // сюда примем значение свойства

);

Параметры

ticket_number

[in] Тикет сделки.

property_id

[in] Идентификатор свойства сделки. Значение может быть одним из значений перечисления

ENUM_DEAL_PROPERTY_DOUBLE.

double_var

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

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

Значение типа double.

Примечание

Не следует путать между собой ордера, сделки и позиции. Каждая сделка является

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

одной или нескольких сделок.

Смотри также

HistoryDealsTotal(), HistorySelect(), HistoryDealGetTicket(), Свойства сделок

Торговые функции

656

HistoryDealGetInteger

Возвращает запрошенное свойство сделки. Свойство сделки должно быть типа datetime, int.

Существует 2 варианта функции.

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

long HistoryDealGetInteger(

ulong ticket_number, // тикет

ENUM_DEAL_PROPERTY_INTEGER property_id // идентификатор свойства

);

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

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

параметром.

bool HistoryDealGetInteger(

ulong ticket_number, // тикет

ENUM_DEAL_PROPERTY_INTEGER property_id, // идентификатор свойства

long& long_var // сюда примем значение свойства

);

Параметры

ticket_number

[in] Тикет сделки.

property_id

[in] Идентификатор свойства сделки. Значение может быть одним из значений перечисления

ENUM_DEAL_PROPERTY_INTEGER.

long_var

[out] Переменная типа long, принимающая значение запрашиваемого свойства.

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

Значение типа long.

Примечание

Не следует путать между собой ордера, сделки и позиции. Каждая сделка является

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

одной или нескольких сделок.

Смотри также

HistoryDealsTotal(), HistorySelect(), HistoryDealGetTicket(), Свойства сделок

Торговые функции

657

HistoryDealGetString

Возвращает запрошенное свойство сделки. Свойство сделки должно быть типа string. Существует

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

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

string HistoryDealGetString(

ulong ticket_number, // тикет

ENUM_DEAL_PROPERTY_STRING property_id // идентификатор свойства

);

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

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

параметром.

bool HistoryDealGetString(

ulong ticket_number, // тикет

ENUM_DEAL_PROPERTY_STRING property_id, // идентификатор свойства

string& string_var // сюда примем значение свойства

);

Параметры

ticket_number

[in] Tикет сделки.

property_id

[in] Идентификатор свойства сделки. Значение может быть одним из значений перечисления

ENUM_DEAL_PROPERTY_STRING.

string_var

[out] Переменная типа string, принимающая значение запрашиваемого свойства.

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

Значение типа string.

Примечание

Не следует путать между собой ордера, сделки и позиции. Каждая сделка является

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

одной или нескольких сделок.

Смотри также

HistoryDealsTotal(), HistorySelect(), HistoryDealGetTicket(), Свойства сделок

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

658

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

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

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

на глобальном уровне mql5-программы.

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

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

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

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

запущенных на клиентском терминале.

Функция

Действие

GlobalVariableCheck

Проверяет существование глобальной

переменной с указанным именем

GlobalVariableTime

Возвращает время последнего доступа к

глобальной переменной

GlobalVariableDel

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

GlobalVariableGet

Запрашивает значение глобальной

переменной

GlobalVariableName

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

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

переменных

GlobalVariableSet

Устанавливает новое значение глобальной

переменной

GlobalVariablesFlush

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

глобальных переменных на диск

GlobalVariableTemp

Устанавливает новое значение глобальной

переменной, которая существует только на

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

GlobalVariableSetOnCondition

Устанавливает новое значение существующей

глобальной переменной по условию

GlobalVariablesDeleteAll

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

префиксом в имени

GlobalVariablesTotal

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

переменных

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

659

GlobalVariableCheck

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

bool GlobalVariableCheck(

string name // имя

);

Параметры

name

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

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

Возвращает значение true, если глобальная переменная существует, иначе возвращает false.

Примечание

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

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

Смотри также

GlobalVariableTime()

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

660

GlobalVariableTime

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

datetime GlobalVariableTime(

string name // имя

);

Параметры

name

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

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

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

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

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

Примечание

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

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

Смотри также

GlobalVariableCheck()