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

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

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

631

PositionGetString

Функция возвращает запрошенное свойство открытой позиции, предварительно выбранной при

помощи функции PositionGetSymbol или PositionSelect. Свойство позиции должно быть типа string.

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

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

string PositionGetString(

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

);

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

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

параметром.

bool PositionGetString(

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

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

);

Параметры

property_id

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

ENUM_POSITION_PROPERTY_STRING.

string_var

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

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

Значение типа string. В случае неудачного выполнения возвращает пустую строку.

Примечание

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

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

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

"Торговля" в панели "Инструменты" клиентского терминала.

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

PositionSelect() непосредственно перед обращением за ними.

Смотри также

PositionGetSymbol(), PositionSelect(), Свойства позиций

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

632

OrdersTotal

Возвращает количество действующих ордеров.

int OrdersTotal();

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

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

Примечание

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

отображаются на вкладке "Торговля" в панели "Инструменты". Ордер – это распоряжение на

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

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

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

Смотри также

OrderSelect(), OrderGetTicket(), Свойства ордеров

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

633

OrderGetTicket

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

работы с ним при помощи функций.

ulong OrderGetTicket(

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

);

Параметры

index

[in] Номер ордера в списке текущих ордеров.

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

Значение типа ulong. В случае неудачного выполнения возвращает 0.

Примечание

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

отображаются на вкладке "Торговля" в панели "Инструменты". Ордер – это распоряжение на

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

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

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

Функция OrderGetTicket() копирует данные об ордере в программное окружение, и

последующие вызовы OrderGetDouble(), OrderGetInteger(), OrderGetString() возвращают ранее

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

изменились цена открытия, уровни Stop Loss / Take Profit или момент истечения), а данные

этому ордеру можно еще получать. Для гарантированного получения свежих данных об ордере

рекомендуется вызывать функцию OrderGetTicket() непосредственно перед обращением за

ними.

Пример:

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

634

void OnStart()

{

datetime from=0;

datetime to=TimeCurrent();

//--- запросить всю историю

HistorySelect(from,to);

//--- переменные для получения значений из свойств ордера

ulong ticket;

double open_price;

double initial_volume;

datetime time_setup;

string symbol;

string type;

long order_magic;

long positionID;

//--- количество текущих отложенных ордеров

uint total=OrdersTotal();

//--- пройдем в цикле по всем ордерам

for(uint i=0;i<total;i++)

{

//--- получим тикет ордера по его позиции в списке

if((ticket=OrderGetTicket(i))>0)

{

//--- получим свойства ордера

open_price= OrderGetDouble(ORDER_PRICE_OPEN);

time_setup= OrderGetInteger(ORDER_TIME_SETUP);

symbol=OrderGetString(ORDER_SYMBOL);

order_magic= OrderGetInteger(ORDER_MAGIC);

positionID = OrderGetInteger(ORDER_POSITION_ID);

initial_volume=OrderGetDouble(ORDER_VOLUME_INITIAL);

type=GetOrderType(OrderGetInteger(ORDER_TYPE));

//--- подготовим и выведм информацию об ордере

printf("#ticket %d %s %G %s at %G was set up at %s",

ticket, // тикет ордера

type, // тип

initial_volume, // выставленный объем

symbol, // символ, по которому выставили

open_price, // указанная цена открытия

TimeToString(time_setup)// время установки ордера

);

}

//---

}

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

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

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

string GetOrderType(long type)

{

string str_type="unknown operation";

switch(type)

{

case (ORDER_TYPE_BUY): return("buy");

case (ORDER_TYPE_SELL): return("sell");

case (ORDER_TYPE_BUY_LIMIT): return("buy limit");

case (ORDER_TYPE_SELL_LIMIT): return("sell limit");

case (ORDER_TYPE_BUY_STOP): return("buy stop");

case (ORDER_TYPE_SELL_STOP): return("sell stop");

case (ORDER_TYPE_BUY_STOP_LIMIT): return("buy stop limit");

case (ORDER_TYPE_SELL_STOP_LIMIT):return("sell stop limit");

}

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

635

return(str_type);

}

Смотри также

OrdersTotal(), OrderSelect(), OrderGetInteger()

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

636

OrderSelect

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

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

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

bool OrderSelect(

ulong ticket // тикет ордера

);

Параметры

ticket

[in] Тикет ордера.

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

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

Примечание

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

отображаются на вкладке "Торговля" в панели "Инструменты" клиентского терминала. По

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

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

Функция OrderSelect() копирует данные об ордере в программное окружение, и последующие

вызовы OrderGetDouble(), OrderGetInteger(), OrderGetString() возвращают ранее скопированные

данные. Это означает, что самого ордера может уже и не быть (или же в нем изменились цена

открытия, уровни Stop Loss / Take Profit или момент истечения), а данные этому ордеру можно

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

вызывать функцию OrderSelect() непосредственно перед обращением за ними.

Смотри также

OrderGetInteger(), OrderGetDouble(), OrderGetString(), OrderCalcProfit(), OrderGetTicket(),

Свойства ордеров

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

637

OrderGetDouble

Возвращает запрошенное свойство ордера, предварительно выбранного при помощи функции

OrderGetTicket или OrderSelect. Свойство ордера должно быть типа double. Существует 2

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

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

double OrderGetDouble(

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

);

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

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

параметром.

bool OrderGetDouble(

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

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

);

Параметры

property_id

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

ENUM_ORDER_PROPERTY_DOUBLE.

double_var

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

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

Значение типа double. В случае неудачного выполнения возвращает 0.

Примечание

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

отображаются на вкладке "Торговля" в панели "Инструменты" клиентского терминала. По

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

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

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

OrderSelect() непосредственно перед обращением за ними.

Смотри также

OrdersTotal(), OrderGetTicket(), Свойства ордеров

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

638

OrderGetInteger

Возвращает запрошенное свойство ордера, предварительно выбранного при помощи функции

OrderGetTicket или OrderSelect. Свойство ордера должно быть типа datetime, int. Существует 2

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

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

long OrderGetInteger(

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

);

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

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

параметром.

bool OrderGetInteger(

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

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

);

Параметры

property_id

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

ENUM_ORDER_PROPERTY_INTEGER.

long_var

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

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

Значение типа long. В случае неудачного выполнения возвращает 0.

Примечание

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

отображаются на вкладке "Торговля" в панели "Инструменты" клиентского терминала. По

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

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

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

OrderSelect() непосредственно перед обращением за ними.

Смотри также

OrdersTotal(), OrderGetTicket(), Свойства ордеров

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

639

OrderGetString

Возвращает запрошенное свойство ордера, предварительно выбранного при помощи функции

OrderGetTicket или OrderSelect. Свойство ордера должно быть типа string. Существует 2 варианта

функции.

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

string OrderGetString(

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

);

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

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

параметром.

bool OrderGetString(

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

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

);

Параметры

property_id

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

ENUM_ORDER_PROPERTY_STRING.

string_var

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

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

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

Примечание

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

отображаются на вкладке "Торговля" в панели "Инструменты" клиентского терминала. По

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

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

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

OrderSelect() непосредственно перед обращением за ними.

Смотри также

OrdersTotal(), OrderGetTicket(), Свойства ордеров

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

640

HistorySelect

Запрашивает историю сделок и ордеров за указанный период серверного времени.

bool HistorySelect(

datetime from_date, // с даты

datetime to_date // по дату

);

Параметры

from_date

[in] Начальная дата запроса.

to_date

[in] Конечная дата запроса.

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

Возвращает true в случае успеха, иначе false.

Примечание

Функция HistorySelect() создает в mql5-программе список ордеров и список сделок для

дальнейшего обращения к элементам списка посредством соответствующих функций. Размер

списка сделок можно узнать с помощью функции HistoryDealsTotal(), размер списка ордеров в

истории можно получить с HistoryOrdersTotal(). Перебор элементов списка ордеров лучше всего

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

подходит функция HistoryDealGetTicket().

После применения функции HistoryOrderSelect() список ордеров в истории, доступных mql5-

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

тикету завершился успешно. То же самое относится к списку сделок, доступных mql5-программе

– он сбрасывается функцией HistoryDealSelect() и заполняется заново в случае успешного

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

Пример: