Справочник по языку программирования MQL5
Подождите немного. Документ загружается.
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1101
SearchLast
Ищет последний элемент равный образцу в сортированном массиве.
int SearchLast(
float element // образец
) const
Параметры
element
[in] Образец элемента для поиска в массиве.
Возвращаемое значение
Позиция найденного элемента в случае успеха, -1 – если элемент не найден.
Пример:
//--- example for CArrayFloat::SearchLast(float)
#include <Arrays\ArrayFloat.mqh>
//---
void OnStart()
{
CArrayFloat *array=new CArrayFloat;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
//--- sort array
array.Sort();
//--- search element
if(array.SearchLast(100.0)!=-1) printf("Element found");
else printf("Element not found");
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1102
Save
Сохраняет данные массива в файле.
virtual bool Save(
int file_handle // хэндл файла
)
Параметры
file_handle
[in] Хэндл ранее открытого, при помощи функции FileOpen(...), бинарного файла.
Возвращаемое значение
true – в случае успешного завершения, false – в случае ошибки.
Пример:
//--- example for CArrayFloat::Save(int)
#include <Arrays\ArrayFloat.mqh>
//---
void OnStart()
{
int file_handle;
CArrayFloat *array=new CArrayFloat;
//---
if(array!=NULL)
{
printf("Object create error");
return;
}
//--- add 100 arrays elements
for(int i=0;i<100;i++)
{
array.Add(i);
}
//--- open file
file_handle=FileOpen("MyFile.bin",FILE_WRITE|FILE_BIN|FILE_ANSI);
if(file_handle>=0)
{
if(!array.Save(file_handle))
{
//--- file save error
printf("File save: Error %d!",GetLastError());
delete array;
FileClose(file_handle);
//---
return;
}
FileClose(file_handle);
}
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1103
Load
Загружает данные массива из файла.
virtual bool Load(
int file_handle // хэндл файла
)
Параметры
file_handle
[in] Хэндл ранее открытого, при помощи функции FileOpen(...), бинарного файла.
Возвращаемое значение
true – в случае успешного завершения, false – в случае ошибки.
Пример:
//--- example for CArrayFloat::Load(int)
#include <Arrays\ArrayFloat.mqh>
//---
void OnStart()
{
int file_handle;
CArrayFloat *array=new CArrayFloat;
//---
if(array!=NULL)
{
printf("Object create error");
return;
}
//--- open file
file_handle=FileOpen("MyFile.bin",FILE_READ|FILE_BIN|FILE_ANSI);
if(file_handle>=0)
{
if(!array.Load(file_handle))
{
//--- file load error
printf("File load: Error %d!",GetLastError());
delete array;
FileClose(file_handle);
//---
return;
}
FileClose(file_handle);
}
//--- use arrays elements
for(int i=0;i<array.Total();i++)
{
printf("Element[%d] = %f",i,array.At(i));
}
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1104
Type
Получает идентификатор типа массива.
virtual int Type() const
Возвращаемое значение
Идентификатор типа массива (для CArrayFloat - 87).
Пример:
//--- example for CArrayFloat::Type()
#include <Arrays\ArrayFloat.mqh>
//---
void OnStart()
{
CArrayFloat *array=new CArrayFloat;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- get array type
int type=array.Type();
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1105
CArrayDouble
Класс CArrayDouble является классом динамического массива переменных типа double.
Описание
Класс CArrayDouble обеспечивает возможность работы с динамическим массивом переменных
типа double. В классе реализованы возможности добавления/вставки/удаления элементов
массива, сортировки массива, поисков в сортированном массиве. Кроме того, реализованы
методы работы с файлом.
Декларация
class CArrayDouble : public CArray
Заголовок
#include <Arrays\ArrayDouble.mqh>
Методы класса по группам
Атрибуты
Delta
Устанавливает величину допуска сравнения
Управление памятью
Reserve
Резервирует память для увеличения размеров
массива
Resize
Устанавливает новый (меньший) размер
массива
Shutdown
Очищает массив с полным освобождением
памяти
Наполнение
Add
Добавляет элемент в конец массива
AddArray
Добавляет в конец массива элементы из
другого массива
AddArray
Добавляет в конец массива элементы из
другого массива
Insert
Вставляет элемент в массив в указанную
позицию
InsertArray
Вставляет в массив элементы из другого
массива с указанной позиции
InsertArray
Вставляет в массив элементы из другого
массива с указанной позиции
AssignArray
Копирует в массив элементы из другого
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1106
массива
AssignArray
Копирует в массив элементы из другого
массива
Изменение
Update
Изменяет элемент в указанной позиции
массива
Shift
Перемещает элемент из указанной позиции
массива на указанное смещение
Удаление
Delete
Удаляет элемент из указанной позиции
массива
DeleteRange
Удаляет группу элементов из указанной
позиции массива
Доступ
At
Получает элемент из указанной позиции
массива
Сравнение
CompareArray
Сравнивает массив с другим массивом
CompareArray
Сравнивает массив с другим массивом
Операции с сортированным массивом
InsertSort
Вставляет элемент в сортированный массив
Search
Ищет элемент равный образцу в
сортированном массиве
SearchGreat
Ищет элемент больше образца в
сортированном массиве
SearchLess
Ищет элемент меньше образца в
сортированном массиве
SearchGreatOrEqual
Ищет элемент больше или равный образцу в
сортированном массиве
SearchLessOrEqual
Ищет элемент меньше или равный образцу в
сортированном массиве
SearchFirst
Ищет первый элемент равный образцу в
сортированном массиве
SearchLast
Ищет последний элемент равный образцу в
сортированном массиве
Ввод/вывод
virtual Save
Сохраняет данные массива в файле
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1107
virtual Load
Загружает данные массива из файла
virtual Type
Получает идентификатор типа массива
Прямые потомки класса:
CIndicatorBuffer
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1108
Delta
Устанавливает допуск сравнения.
void Delta(
double delta // допуск
)
Параметры
delta
[in] новое значение допуска сравнения.
Возвращаемое значение
Нет
Примечание
Допуск сравнения используется при поисках. Значения считаются равными, если их разница
меньше или равна допуску. По умолчанию допуск равен 0.0.
Пример:
//--- example for CArrayDouble::Delta(double)
#include <Arrays\ArrayDouble.mqh>
//---
void OnStart()
{
CArrayDouble *array=new CArrayDouble;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- set compare variation
array.Delta(0.001);
//--- use array
//--- . . .
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1109
Reserve
Резервирует память для увеличения размеров массива.
bool Reserve(
int size // количество
)
Параметры
size
[in] Количество дополнительных элементов массива.
Возвращаемое значение
true в случае успеха, false – если была попытка запросить количество меньше или равное нулю,
либо если массив увеличить не удалось.
Примечание
Для уменьшения фрагментации памяти, приращение размеров массива производится с шагом
ранее заданным через метод Step(int), либо 16 (по умолчанию).
Пример:
//--- example for CArrayDouble::Reserve(int)
#include <Arrays\ArrayDouble.mqh>
//---
void OnStart()
{
CArrayDouble *array=new CArrayDouble;
//---
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;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1110
Resize
Устанавливает новый (меньший) размер массива.
bool Resize(
int size // размер
)
Параметры
size
[in] Новый размер массива.
Возвращаемое значение
true в случае успеха, false – если была попытка установить размер меньше или равный нулю.
Примечание
Изменение размера массива позволяет оптимально использовать память. Лишние элементы
справа теряются. Для уменьшения фрагментации памяти, изменение размеров массива
производится с шагом ранее заданным через метод Step(int), либо 16 (по умолчанию).
Пример:
//--- example for CArrayDouble::Resize(int)
#include <Arrays\ArrayDouble.mqh>
//---
void OnStart()
{
CArrayDouble *array=new CArrayDouble;
//---
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;
}