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

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

Стандартная библиотека

921

//--- example for CObject::Compare(...)

#include <Object.mqh>

//---

void OnStart()

{

CObject *object_first,*object_second;

//---

object_first=new CObject;

if(object_first==NULL)

{

printf("Object create error");

return;

}

object_second=new CObject;

if(object_second==NULL)

{

printf("Object create error");

delete object_first;

return;

}

//--- set interconnect

object_first.Next(object_second);

object_second.Prev(object_first);

//--- compare objects

int result=object_first.Compare(object_second);

//--- delete objects

delete object_first;

delete object_second;

}

Стандартная библиотека

922

Save

Сохраняет данные элемента списка в файле.

virtual bool Save(

int file_handle // хэндл файла

)

Параметры

file_handle

[in] Хэндл ранее открытого, при помощи функции FileOpen(), бинарного файла

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

true – в случае успешного завершения, false – в случае ошибки.

Примечание

Метод Save(int) в классе CObject всегда возвращает true и не выполняет каких-либо действий.

При необходимости сохранения данных класса-наследника в файле, метод Save(int) должен

быть реализован.

Пример:

Стандартная библиотека

923

//--- example for CObject::Save(int)

#include <Object.mqh>

//---

void OnStart()

{

int file_handle;

CObject *object=new CObject;

//---

if(object!=NULL)

{

printf("Object create error");

return;

}

//--- set objects data

//--- . . .

//--- open file

file_handle=FileOpen("MyFile.bin",FILE_WRITE|FILE_BIN|FILE_ANSI);

if(file_handle>=0)

{

if(!object.Save(file_handle))

{

//--- file save error

printf("File save: Error %d!",GetLastError());

delete object;

FileClose(file_handle);

//---

return;

}

FileClose(file_handle);

}

delete object;

}

Стандартная библиотека

924

Load

Загружает данные элемента списка из файла.

virtual bool Load(

int file_handle // хэндл файла

)

Параметры

file_handle

[in] Хэндл ранее открытого, при помощи функции FileOpen(), бинарного файла

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

true – в случае успешного завершения, false – в случае ошибки.

Примечание

Метод Load(int) в классе CObject всегда возвращает true и не выполняет каких-либо действий.

При необходимости загрузки данных класса-наследника из файла, метод Load(int) должен быть

реализован.

Пример:

Стандартная библиотека

925

//--- example for CObject::Load(int)

#include <Object.mqh>

//---

void OnStart()

{

int file_handle;

CObject *object=new CObject;

//---

if(object!=NULL)

{

printf("Object create error");

return;

}

//--- open file

file_handle=FileOpen("MyFile.bin",FILE_READ|FILE_BIN|FILE_ANSI);

if(file_handle>=0)

{

if(!object.Load(file_handle))

{

//--- file load error

printf("File load: Error %d!",GetLastError());

delete object;

FileClose(file_handle);

//---

return;

}

FileClose(file_handle);

}

//--- use object

//--- . . .

delete object;

}

Стандартная библиотека

926

Type

Получает идентификатор типа.

virtual int Type() const

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

Идентификатор типа (для CObject - 0).

Пример:

//--- example for CObject::Type()

#include <Object.mqh>

//---

void OnStart()

{

CObject *object=new CObject;

//---

object=new CObject;

if(object ==NULL)

{

printf("Object create error");

return;

}

//--- get objects type

int type=object.Type();

//--- delete object

delete object;

}

Стандартная библиотека

927

Структуры данных

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

связанными списками и др.) и описание соответствующих компонентов стандартной библиотеки

MQL5.

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

пользовательских хранилищ данных разнообразных форматов (в том числе составных структур

данных).

Стандартная библиотека MQL5 (в части наборов данных) размещается в рабочем каталоге

терминала в папке Include\Arrays

Массивы данных

Использование классов динамических массивов данных позволит сэкономить время при создании

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

массивов).

Стандартная библиотека MQL5 (в части массивов данных) размещается в рабочем каталоге

терминала в папке Include\Arrays.

Класс

Описание

Базовый класс динамического массива CArray

Базовый класс динамического массива

данных

CArrayChar

Динамический массив переменных типа char

или uchar

CArrayShort

Динамический массив переменных типа short

или ushort

CArrayInt

Динамический массив переменных типа int

или uint

CArrayLong

Динамический массив переменных типа long

или ulong

CArrayFloat

Динамический массив переменных типа float

CArrayDouble

Динамический массив переменных типа

double

CArrayString

Динамический массив переменных типа string

Базовый класс объектов CArrayObj

Динамический массив указателей CObject

Базовый класс списка CList

Обеспечивает возможность работы со

списком экземпляров класса CObject и его

наследников

CTreeNode

Обеспечивает возможность работы с узлами

двоичного дерева CTree

Стандартная библиотека

928

CTree

Обеспечивает возможность работы с

двоичным деревом экземпляров класса

CTreeNode и его наследников.

Стандартная библиотека

929

CArray

Класс CArray является базовым классом динамического массива переменных.

Описание

Класс CArray обеспечивает возможность работы с динамическим массивом переменных в части

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

Декларация

class CArray : public CObject

Заголовок

#include <Arrays\Array.mqh>

Методы класса по группам

Атрибуты

Step

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

Step

Устанавливает шаг приращения размеров

массива

Total

Получает количество элементов в массиве

Available

Получает количество свободных элементов

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

распределения памяти

Max

Получает максимально возможный размер

массива без перевыделения памяти

IsSorted

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

по указанному варианту

SortMode

Получает вариант сортировки массива

Метод очистки

Clear

Удаляет все элементы массива без

освобождения памяти

Сортировка

Sort

Сортирует массив по указанному варианту

Ввод/вывод

virtual Save

Сохраняет данные массива в файле

virtual Load

Загружает данные массива из файла

Прямые потомки класса:

Стандартная библиотека

930

CArrayChar

CArrayShort

CArrayInt

CArrayLong

CArrayFloat

CArrayDouble

CArrayString

CArrayObj