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

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

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

1071

CArrayFloat

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

Описание

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

float. В классе реализованы возможности добавления/вставки/удаления элементов массива,

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

с файлом.

Декларация

class CArrayFloat : public CArray

Заголовок

#include <Arrays\ArrayFloat.mqh>

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

Атрибуты

Delta

Устанавливает величину допуска сравнения

Управление памятью

Reserve

Резервирует память для увеличения размеров

массива

Resize

Устанавливает новый (меньший) размер

массива

Shutdown

Очищает массив с полным освобождением

памяти

Наполнение

Add

Добавляет элемент в конец массива

AddArray

Добавляет в конец массива элементы из

другого массива

AddArray

Добавляет в конец массива элементы из

другого массива

Insert

Вставляет элемент в массив в указанную

позицию

InsertArray

Вставляет в массив элементы из другого

массива с указанной позиции

InsertArray

Вставляет в массив элементы из другого

массива с указанной позиции

AssignArray

Копирует в массив элементы из другого

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

1072

массива

AssignArray

Копирует в массив элементы из другого

массива

Изменение

Update

Изменяет элемент в указанной позиции

массива

Shift

Перемещает элемент из указанной позиции

массива на указанное смещение

Удаление

Delete

Удаляет элемент из указанной позиции

массива

DeleteRange

Удаляет группу элементов из указанной

позиции массива

Доступ

Получает элемент из указанной позиции

массива

Сравнение

CompareArray

Сравнивает массив с другим массивом

CompareArray

Сравнивает массив с другим массивом

Операции с сортированным массивом

InsertSort

Вставляет элемент в сортированный массив

Ищет элемент равный образцу в

сортированном массиве

SearchGreat

Ищет элемент больше образца в

сортированном массиве

SearchLess

Ищет элемент меньше образца в

сортированном массиве

SearchGreatOrEqual

Ищет элемент больше или равный образцу в

сортированном массиве

SearchLessOrEqual

Ищет элемент меньше или равный образцу в

сортированном массиве

SearchFirst

Ищет первый элемент равный образцу в

сортированном массиве

SearchLast

Ищет последний элемент равный образцу в

сортированном массиве

Ввод/вывод

virtual Save

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

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

1073

virtual Load

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

virtual Type

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

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

1074

Delta

Устанавливает допуск сравнения.

void Delta(

float delta // допуск

)

Параметры

delta

[in] новое значение допуска сравнения.

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

Нет

Примечание

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

меньше или равна допуску. По умолчанию допуск равен 0.0.

Пример:

//--- example for CArrayFloat::Delta(float)

#include <Arrays\ArrayFloat.mqh>

//---

void OnStart()

{

CArrayFloat *array=new CArrayFloat;

//---

if(array==NULL)

{

printf("Object create error");

return;

}

//--- set compare variation

array.Delta(0.001);

//--- use array

//--- . . .

//--- delete array

delete array;

}

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

1075

Reserve

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

bool Reserve(

int size // количество

)

Параметры

size

[in] Количество дополнительных элементов массива.

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

true в случае успеха, false – если была попытка запросить количество меньше или равное нулю,

либо если массив увеличить не удалось.

Примечание

Для уменьшения фрагментации памяти, приращение размеров массива производится с шагом

ранее заданным через метод Step(int), либо 16 (по умолчанию).

Пример:

//--- example for CArrayFloat::Reserve(int)

#include <Arrays\ArrayFloat.mqh>

//---

void OnStart()

{

CArrayFloat *array=new CArrayFloat;

//---

if(array==NULL)

{

printf("Object create error");

return;

}

//--- reserve memory

if(!array.Reserve(1024))

{

printf("Reserve error");

delete array;

return;

}

//--- use array

//--- . . .

//--- delete array

delete array;

}

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

1076

Resize

Устанавливает новый (меньший) размер массива.

bool Resize(

int size // размер

)

Параметры

size

[in] Новый размер массива.

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

true в случае успеха, false – если была попытка установить размер меньше или равный нулю.

Примечание

Изменение размера массива позволяет оптимально использовать память. Лишние элементы

справа теряются. Для уменьшения фрагментации памяти, изменение размеров массива

производится с шагом ранее заданным через метод Step(int), либо 16 (по умолчанию).

Пример:

//--- example for CArrayFloat::Resize(int)

#include <Arrays\ArrayFloat.mqh>

//---

void OnStart()

{

CArrayFloat *array=new CArrayFloat;

//---

if(array==NULL)

{

printf("Object create error");

return;

}

//--- add arrays elements

//--- . . .

//--- resize array

if(!array.Resize(10))

{

printf("Resize error");

delete array;

return;

}

//--- delete array

delete array;

}

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

1077

Shutdown

Очищает массив с полным освобождением памяти.

bool Shutdown()

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

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

Пример:

//--- example for CArrayFloat::Shutdown()

#include <Arrays\ArrayFloat.mqh>

//---

void OnStart()

{

CArrayFloat *array=new CArrayFloat;

//---

if(array==NULL)

{

printf("Object create error");

return;

}

//--- add arrays elements

//--- . . .

//--- shutdown array

if(!array.Shutdown())

{

printf("Shutdown error");

delete array;

return;

}

//--- delete array

delete array;

}

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

1078

Add

Добавляет элемент в конец массива.

bool Add(

float element // элемент для добавления

)

Параметры

element

[in] Значение элемента для добавления в массив.

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

true в случае успеха, false – если нет возможности добавить элемент.

Пример:

//--- example for CArrayFloat::Add(float)

#include <Arrays\ArrayFloat.mqh>

//---

void OnStart()

{

CArrayFloat *array=new CArrayFloat;

//---

if(array==NULL)

{

printf("Object create error");

return;

}

//--- add arrays elements

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

{

if(!array.Add(i))

{

printf("Element addition error");

delete array;

return;

}

//--- use array

//--- . . .

//--- delete array

delete array;

}

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

1079

AddArray

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

bool AddArray(

const float& src[] // массив-источник

)

Параметры

src[]

[in] Ссылка на массив-источник элементов для добавления.

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

true в случае успеха, false – если нет возможности добавить элементы.

Пример:

//--- example for CArrayFloat::AddArray(const float &[])

#include <Arrays\ArrayFloat.mqh>

//---

float src[];

//---

void OnStart()

{

CArrayFloat *array=new CArrayFloat;

//---

if(array==NULL)

{

printf("Object create error");

return;

}

//--- add another array

if(!array.AddArray(src))

{

printf("Array addition error");

delete array;

return;

}

//--- use array

//--- . . .

//--- delete array

delete array;

}

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

1080

AddArray

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

bool AddArray(

const CArrayFloat* src // указатель на источник

)

Параметры

src

[in] Указатель на экземпляр класса CArrayFloat-источник элементов для добавления.

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

true в случае успеха, false – если нет возможности добавить элементы.

Пример:

//--- example for CArrayFloat::AddArray(const CArrayFloat*)

#include <Arrays\ArrayFloat.mqh>

//---

void OnStart()

{

CArrayFloat *array=new CArrayFloat;

//---

if(array==NULL)

{

printf("Object create error");

return;

}

//--- create source array

CArrayFloat *src=new CArrayFloat;

if(src==NULL)

{

printf("Object create error");

delete array;

return;

}

//--- add source arrays elements

//--- . . .

//--- add another array

if(!array.AddArray(src))

{

printf("Array addition error");

delete src;

delete array;

return;

}

//--- delete source array

delete src;

//--- use array

//--- . . .

//--- delete array

delete array;

}