Справочник по языку программирования MQL5
Подождите немного. Документ загружается.
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1001
SearchFirst
Ищет первый элемент равный образцу в сортированном массиве.
int SearchFirst(
short element // образец
) const
Параметры
element
[in] Образец элемента для поиска в массиве.
Возвращаемое значение
Позиция найденного элемента в случае успеха, -1 – если элемент не найден.
Пример:
//--- example for CArrayShort::SearchFirst(short)
#include <Arrays\ArrayShort.mqh>
//---
void OnStart()
{
CArrayShort *array=new CArrayShort;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
//--- sort array
array.Sort();
//--- search element
if(array.SearchFirst(100)!=-1) printf("Element found");
else printf("Element not found");
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1002
SearchLast
Ищет последний элемент равный образцу в сортированном массиве.
int SearchLast(
short element // образец
) const
Параметры
element
[in] Образец элемента для поиска в массиве.
Возвращаемое значение
Позиция найденного элемента в случае успеха, -1 – если элемент не найден.
Пример:
//--- example for CArrayShort::SearchLast(short)
#include <Arrays\ArrayShort.mqh>
//---
void OnStart()
{
CArrayShort *array=new CArrayShort;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
//--- sort array
array.Sort();
//--- search element
if(array.SearchLast(100)!=-1) printf("Element found");
else printf("Element not found");
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1003
Save
Сохраняет данные массива в файле.
virtual bool Save(
int file_handle // хэндл файла
)
Параметры
file_handle
[in] Хэндл ранее открытого, при помощи функции FileOpen(...), бинарного файла.
Возвращаемое значение
true – в случае успешного завершения, false – в случае ошибки.
Пример:
//--- example for CArrayShort::Save(int)
#include <Arrays\ArrayShort.mqh>
//---
void OnStart()
{
int file_handle;
CArrayShort *array=new CArrayShort;
//---
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.
1004
Load
Загружает данные массива из файла.
virtual bool Load(
int file_handle // хэндл файла
)
Параметры
file_handle
[in] Хэндл ранее открытого, при помощи функции FileOpen(...), бинарного файла.
Возвращаемое значение
true – в случае успешного завершения, false – в случае ошибки.
Пример:
//--- example for CArrayShort::Load(int)
#include <Arrays\ArrayShort.mqh>
//---
void OnStart()
{
int file_handle;
CArrayShort *array=new CArrayShort;
//---
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] = %d",i,array.At(i));
}
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1005
Type
Получает идентификатор типа массива.
virtual int Type() const
Возвращаемое значение
Идентификатор типа массива (для CArrayShort - 82).
Пример:
//--- example for CArrayShort::Type()
#include <Arrays\ArrayShort.mqh>
//---
void OnStart()
{
CArrayShort *array=new CArrayShort;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- get array type
int type=array.Type();
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1006
CArrayInt
Класс CArrayInt является классом динамического массива переменных типа int или uint.
Описание
Класс CArrayInt обеспечивает возможность работы с динамическим массивом переменных типа int
или uint. В классе реализованы возможности добавления/вставки/удаления элементов массива,
сортировки массива, поисков в сортированном массиве. Кроме того, реализованы методы работы
с файлом.
Декларация
class CArrayInt : public CArray
Заголовок
#include <Arrays\ArrayInt.mqh>
Методы класса по группам
Управление памятью
Reserve
Резервирует память для увеличения размеров
массива
Resize
Устанавливает новый (меньший) размер
массива
Shutdown
Очищает массив с полным освобождением
памяти
Наполнение
Add
Добавляет элемент в конец массива
AddArray
Добавляет в конец массива элементы из
другого массива
AddArray
Добавляет в конец массива элементы из
другого массива
Insert
Вставляет элемент в массив в указанную
позицию
InsertArray
Вставляет в массив элементы из другого
массива с указанной позиции
InsertArray
Вставляет в массив элементы из другого
массива с указанной позиции
AssignArray
Копирует в массив элементы из другого
массива
AssignArray
Копирует в массив элементы из другого
массива
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1007
Изменение
Update
Изменяет элемент в указанной позиции
массива
Shift
Перемещает элемент из указанной позиции
массива на указанное смещение
Удаление
Delete
Удаляет элемент из указанной позиции
массива
DeleteRange
Удаляет группу элементов из указанной
позиции массива
Доступ
At
Получает элемент из указанной позиции
массива
Сравнение
CompareArray
Сравнивает массив с другим массивом
CompareArray
Сравнивает массив с другим массивом
Операции с сортированным массивом
InsertSort
Вставляет элемент в сортированный массив
Search
Ищет элемент равный образцу в
сортированном массиве
SearchGreat
Ищет элемент больше образца в
сортированном массиве
SearchLess
Ищет элемент меньше образца в
сортированном массиве
SearchGreatOrEqual
Ищет элемент больше или равный образцу в
сортированном массиве
SearchLessOrEqual
Ищет элемент меньше или равный образцу в
сортированном массиве
SearchFirst
Ищет первый элемент равный образцу в
сортированном массиве
SearchLast
Ищет последний элемент равный образцу в
сортированном массиве
Ввод/вывод
virtual Save
Сохраняет данные массива в файле
virtual Load
Загружает данные массива из файла
virtual Type
Получает идентификатор типа массива
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1008
Reserve
Резервирует память для увеличения размеров массива.
bool Reserve(
int size // количество
)
Параметры
size
[in] Количество дополнительных элементов массива.
Возвращаемое значение
true в случае успеха, false – если была попытка запросить количество меньше или равное нулю,
либо если массив увеличить не удалось.
Примечание
Для уменьшения фрагментации памяти, приращение размеров массива производится с шагом
ранее заданным через метод Step(int), либо 16 (по умолчанию).
Пример:
//--- example for CArrayInt::Reserve(int)
#include <Arrays\ArrayInt.mqh>
//---
void OnStart()
{
CArrayInt *array=new CArrayInt;
//---
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.
1009
Resize
Устанавливает новый (меньший) размер массива.
bool Resize(
int size // размер
)
Параметры
size
[in] Новый размер массива.
Возвращаемое значение
true в случае успеха, false – если была попытка установить размер меньше или равный нулю.
Примечание
Изменение размера массива позволяет оптимально использовать память. Лишние элементы
справа теряются. Для уменьшения фрагментации памяти, изменение размеров массива
производится с шагом ранее заданным через метод Step(int), либо 16 (по умолчанию).
Пример:
//--- example for CArrayInt::Resize(int)
#include <Arrays\ArrayInt.mqh>
//---
void OnStart()
{
CArrayInt *array=new CArrayInt;
//---
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;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1010
Shutdown
Очищает массив с полным освобождением памяти.
bool Shutdown()
Возвращаемое значение
true в случае успеха, false – если произошла ошибка.
Пример:
//--- example for CArrayInt::Shutdown()
#include <Arrays\ArrayInt.mqh>
//---
void OnStart()
{
CArrayInt *array=new CArrayInt;
//---
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;
}