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

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

Общие функции

371

GetPointer

Возвращает указатель объекта.

void* GetPointer(

any_class anyobject // объект любого класса

);

Параметры

anyobject

[in] Объект любого класса.

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

Возвращает указатель объекта.

Примечание

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

указателей не имеют. Объект класса, который не создан при помощи оператора new(), а

например, автоматически созданный в массиве объектов, все равно имеет указатель. Только

этот указатель будет иметь автоматический тип POINTER_AUTOMATIC, и к нему нельзя

применить оператор delete(). В остальном указатель типа ничем не отличается от динамических

указателей типа POINTER_AUTOMATIC.

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

функцию GetPointer() запрещено. Также запрещается в качества аргумента функции

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

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

программы. Поэтому существует необходимость использования функции CheckPointer() перед

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

указатель равен NULL;

если объект был уничтожен при помощи оператора delete.

Данную функцию можно использовать как проверку указателя на корректность. Значение,

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

Пример:

Общие функции

372

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

//| Check_GetPointer.mq5 |

//| http://www.mql5.com |

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

#property copyright "2009, MetaQuotes Software Corp."

#property link "http://www.mql5.com"

#property version "1.00"

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

//| класс, реализующий элемент списка |

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

class CItem

{

int m_id;

string m_comment;

CItem* m_next;

public:

CItem() { m_id=0; m_comment=NULL; m_next=NULL; }

~CItem() { Print("Destructor of ",m_id,

(CheckPointer(GetPointer(this))==POINTER_DYNAMIC)?

"dynamic":"non-dynamic"); }

void Initialize(int id,string comm) { m_id=id; m_comment=comm; }

void PrintMe() { Print(__FUNCTION__,":",m_id,m_comment); }

int Identifier() { return(m_id); }

CItem* Next() {return(m_next); }

void Next(CItem *item) { m_next=item; }

};

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

//| простейший класс списка |

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

class CMyList

{

CItem* m_items;

public:

CMyList() { m_items=NULL; }

~CMyList() { Destroy(); }

bool InsertToBegin(CItem* item);

void Destroy();

};

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

//| вставка элемента списка в самое начало |

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

bool CMyList::InsertToBegin(CItem* item)

{

if(CheckPointer(item)==POINTER_INVALID) return(false);

//---

item.Next(m_items);

m_items=item;

//---

return(true);

}

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

//| уничтожение списка через уничтожение элементов |

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

void CMyList::Destroy()

{

//--- служебный указатель для работы в цикле

CItem* item;

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

while(CheckPointer(m_items)!=POINTER_INVALID)

Общие функции

373

{

item=m_items;

m_items=m_items.Next();

if(CheckPointer(item)==POINTER_DYNAMIC)

{

Print("Dynamyc object",item.Identifier(),"to be deleted");

delete (item);

}

else Print("Non-dynamic object",item.Identifier(),"cannot be deleted");

}

//---

}

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

//| Script program start function |

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

void OnStart()

{

CMyList list;

CItem items[10];

CItem* item;

//--- создадим и добавим в список динамический указатель объекта

item=new CItem;

if(item!=NULL)

{

item.Initialize(100,"dynamic");

item.PrintMe();

list.InsertToBegin(item);

}

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

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

{

items[i].Initialize(i,"automatic");

items[i].PrintMe();

item=GetPointer(items[i]);

if(CheckPointer(item)!=POINTER_INVALID)

list.InsertToBegin(item);

}

//--- добавим еще один динамический указатель объекта в начало списка

item=new CItem;

if(item!=NULL)

{

item.Initialize(200,"dynamic");

item.PrintMe();

list.InsertToBegin(item);

}

//--- удалим элементы списка

list.Destroy();

//--- все элементы списка будут уничтожены,

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

}

Смотри также

Указатели объектов, Проверка указателя объекта, Оператор уничтожения объекта delete

Общие функции

374

GetTickCount

Функция GetTickCount() возвращает количество миллисекунд, прошедших с момента старта

системы.

uint GetTickCount();

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

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

Примечание

Счетчик ограничен разрешающей способностью системного таймера. Так как время хранится

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

компьютера.

Общие функции

375

MessageBox

Создает и отображает окно сообщений, а также управляет им. Окно сообщений содержит

сообщение и заголовок, любую комбинацию предопределенных значков и командных кнопок.

int MessageBox(

string text, // текст сообщения

string caption=NULL, // заголовок окна

int flags=0 // определяет набор кнопок в окне

);

Параметры

text

[in] Текст, содержащий сообщение для отображения.

caption=NULL

[in] Необязательный текст для отображения в заголовке окна сообщения. Если этот параметр

пустой, в заголовке окна будет отображено название эксперта.

flags=0

[in] Необязательные флаги, определяющие вид и поведение диалогового окна. Флаги могут

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

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

Если функция успешно выполняется, возвращаемое значение - одно из значений кодов возврата

MessageBox().

Примечание

Функцию нельзя вызывать из пользовательских индикаторов, так как индикаторы выполняются

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

Общие функции

376

PeriodSeconds

Возвращает количество секунд в периоде.

int PeriodSeconds(

ENUM_TIMEFRAMES period=PERIOD_CURRENT // период графика

);

Параметры

period=PERIOD_CURRENT

[in] Значение периода графика из перечисления ENUM_TIMEFRAMES. Если параметр не

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

программа.

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

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

Смотри также

_Period, Периоды графиков, Дата и время, Видимость объектов

Общие функции

377

PlaySound

Воспроизводит звуковой файл.

bool PlaySound(

string filename // имя файла

);

Параметры

filename

[in] Путь к звуковому файлу.

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

true – если звуковой файл найден, иначе возвращает false.

Примечание

Файл должен быть расположен в каталоге каталог_терминала\Sounds или его подкаталоге.

Проигрываются только звуковые файлы в формате WAV.

Смотри также

Ресурсы

Общие функции

378

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

void Print(

argument, // первое значение

... // последующие значения

);

Параметры

...

[in] Любые значения, разделенные запятыми. Количество параметров не может превышать

64.

Примечание

Массивы нельзя передавать в функцию Print(). Массивы должны печататься поэлементно.

Данные типа double выводятся с точностью до 16 десятичных цифр после точки, при этом

данные могут выводиться либо в традиционном либо в научном формате – в зависимости от

того, как запись будет наиболее компактна. Данные типа float выводятся с 5 десятичными

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

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

Данные типа bool выводятся в виде строк "true" или "false". Даты выводятся в виде YYYY.MM.DD

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

(). Данные типа color выводятся либо в виде строки R,G,B, либо в виде названия цвета, если

этот цвет присутствует в наборе цветов.

Пример:

Print("Время последней пришедшей котировки ",TimeCurrent());

Смотри также

PrintFormat, StringFormat

Общие функции

379

PrintFormat

Форматирует и печатает наборы символов и значений в журнал экспертов в соответствии с

заданным форматом.

void PrintFormat(

string format_string, // форматная строка

... // значения простых типов

);

Параметры

format_string

[in] Строка формата состоит из обычных символов и, если за строкой формата следуют

аргументы, еще и спецификации формата.

...

[in] Любые значения простых типов, разделенные запятыми. Общее количество параметров

не может превышать 64, включая форматную строку.

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

Строка.

Примечание

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

в противном случае результат печати неопределён. В противном случае результат печати

неопределён. Вместо функции PrintFormat() можно использовать функцию printf().

Если за строкой формата следуют еще параметры, то эта строка должна содержать

спецификации формата, определяющие формат вывода этих параметров. Спецификация

формата всегда начинается с символа знака процента (%).

Строка формата читается слева направо. Когда встречается первая спецификация формата

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

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

преобразование и вывод второго параметра и так далее, до конца строки формата.

Спецификация формата имеет следующую форму:

%[flags][width][.precision][{h | l | ll | I32 | I64}]type

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

обозначающим обычную форматную опцию. Простейшая спецификация формата содержит

только знак процента (%) и символ, определяющий типвыводимогопараметра (например %s).

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

форматную спецификацию %%.

flags

Флаг

Описание

Поведение по умолчанию

Общие функции

380

– (минус)

Выравнивание по левому

краю в пределах заданной

ширины

Выравнивание по правому

краю

+ (плюс)

Вывод знака + или - для

значений знаковых типов

Знак выводится только если

значение отрицательное

0 (ноль)

Перед выводимом

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

в пределах заданной

ширины. Если указан флаг 0

с целочисленным форматом

(i, u, x, X, o, d) и задана

спецификация точности

(например, %04.d), то 0

игнорируется.

Ничего не вставляется

пробел

Перед выводимым

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

если значение является

знаковым и положительным

Пробелы не вставляются

Если используется совместно

с форматом o, x или X, то

перед выводимым

значением добавляется 0,

0x или 0X соответственно.

Ничего не вставляется

Если используется совместно

с форматом e, E, a или A, то

значение всегда выводится

с десятичной точкой.

Десятичная точка выводится

только если есть ненулевая

дробная часть.

Если используется совместно

с форматом g или G, флаг

определяет наличие

десятичной точки в

выводимом значении и

препятствует отсечению

ведущих нулей.

Флаг # игнорируется при

совместном использовании с

форматами c, d, i, u, s.

Десятичная точка выводится

только если есть ненулевая

дробная часть. Ведущие

нули отсекаются

width

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

отформатированного значения. Если количество выводимых символов меньше указанной

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

от выравнивания (флаг –). При наличии флага ноль (0), перед выводимым значением

добавляется соответствующее количество нулей. Если число выводимых символов больше