Справочник по языку программирования MQL5
Подождите немного. Документ загружается.
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
971
Save
Сохраняет данные массива в файле.
virtual bool Save(
int file_handle // хэндл файла
)
Параметры
file_handle
[in] Хэндл ранее открытого, при помощи функции FileOpen(...), бинарного файла.
Возвращаемое значение
true – в случае успешного завершения, false – в случае ошибки.
Пример:
//--- example for CArrayChar::Save(int)
#include <Arrays\ArrayChar.mqh>
//---
void OnStart()
{
int file_handle;
CArrayChar *array=new CArrayChar;
//---
if(array!=NULL)
{
printf("Object create error");
return;
}
//--- 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
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
972
Load
Загружает данные массива из файла.
virtual bool Load(
int file_handle // хэндл файла
)
Параметры
file_handle
[in] Хэндл ранее открытого, при помощи функции FileOpen(...), бинарного файла.
Возвращаемое значение
true – в случае успешного завершения, false – в случае ошибки.
Пример:
//--- example for CArrayChar::Load(int)
#include <Arrays\ArrayChar.mqh>
//---
void OnStart()
{
int file_handle;
CArrayChar *array=new CArrayChar;
//---
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] = ’%c’",i,array.At(i));
}
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
973
Type
Получает идентификатор типа массива.
virtual int Type() const
Возвращаемое значение
Идентификатор типа массива (для CArrayChar - 77).
Пример:
//--- example for CArrayChar::Type()
#include <Arrays\ArrayChar.mqh>
//---
void OnStart()
{
CArrayChar *array=new CArrayChar;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- get array type
int type=array.Type();
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
974
CArrayShort
Класс CArrayShort является классом динамического массива переменных типа short или ushort.
Описание
Класс CArrayShort обеспечивает возможность работы с динамическим массивом переменных типа
short или ushort. В классе реализованы возможности добавления/вставки/удаления элементов
массива, сортировки массива, поисков в сортированном массиве. Кроме того, реализованы
методы работы с файлом.
Декларация
class CArrayShort : public CArray
Заголовок
#include <Arrays\ArrayShort.mqh>
Методы класса по группам
Управление памятью
Reserve
Резервирует память для увеличения размеров
массива
Resize
Устанавливает новый (меньший) размер
массива
Shutdown
Очищает массив с полным освобождением
памяти
Наполнение
Add
Добавляет элемент в конец массива
AddArray
Добавляет в конец массива элементы из
другого массива
AddArray
Добавляет в конец массива элементы из
другого массива
Insert
Вставляет элемент в массив в указанную
позицию
InsertArray
Вставляет в массив элементы из другого
массива с указанной позиции
InsertArray
Вставляет в массив элементы из другого
массива с указанной позиции
AssignArray
Копирует в массив элементы из другого
массива
AssignArray
Копирует в массив элементы из другого
массива
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
975
Изменение
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.
976
Reserve
Резервирует память для увеличения размеров массива.
bool Reserve(
int size // количество
)
Параметры
size
[in] Количество дополнительных элементов массива.
Возвращаемое значение
true в случае успеха, false – если была попытка запросить количество меньше или равное нулю,
либо если массив увеличить не удалось.
Примечание
Для уменьшения фрагментации памяти, приращение размеров массива производится с шагом
ранее заданным через метод Step(int), либо 16 (по умолчанию).
Пример:
//--- example for CArrayShort::Reserve(int)
#include <Arrays\ArrayShort.mqh>
//---
void OnStart()
{
CArrayShort *array=new CArrayShort;
//---
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.
977
Resize
Устанавливает новый (меньший) размер массива.
bool Resize(
int size // размер
)
Параметры
size
[in] Новый размер массива.
Возвращаемое значение
true в случае успеха, false – если была попытка установить размер меньше или равный нулю.
Примечание
Изменение размера массива позволяет оптимально использовать память. Лишние элементы
справа теряются. Для уменьшения фрагментации памяти, изменение размеров массива
производится с шагом ранее заданным через метод Step(int), либо 16 (по умолчанию).
Пример:
//--- example for CArrayShort::Resize(int)
#include <Arrays\ArrayShort.mqh>
//---
void OnStart()
{
CArrayShort *array=new CArrayShort;
//---
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.
978
Shutdown
Очищает массив с полным освобождением памяти.
bool Shutdown()
Возвращаемое значение
true в случае успеха, false – если произошла ошибка.
Пример:
//--- example for CArrayShort::Shutdown()
#include <Arrays\ArrayShort.mqh>
//---
void OnStart()
{
CArrayShort *array=new CArrayShort;
//---
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;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
979
Add
Добавляет элемент в конец массива.
bool Add(
short element // элемент для добавления
)
Параметры
element
[in] Значение элемента для добавления в массив.
Возвращаемое значение
true в случае успеха, false – если нет возможности добавить элемент.
Пример:
//--- example for CArrayShort::Add(short)
#include <Arrays\ArrayShort.mqh>
//---
void OnStart()
{
CArrayShort *array=new CArrayShort;
//---
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;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
980
AddArray
Добавляет в конец массива элементы из другого массива.
bool AddArray(
const short& src[] // массив-источник
)
Параметры
src[]
[in] Ссылка на массив-источник элементов для добавления.
Возвращаемое значение
true в случае успеха, false – если нет возможности добавить элементы.
Пример:
//--- example for CArrayShort::AddArray(const short &[])
#include <Arrays\ArrayShort.mqh>
//---
short src[];
//---
void OnStart()
{
CArrayShort *array=new CArrayShort;
//---
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;
}