Справочник по языку программирования MQL5
Подождите немного. Документ загружается.
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
941
Load
Загружает данные массива из файла.
virtual bool Load(
int file_handle // хэндл файла
)
Параметры
file_handle
[in] Хэндл ранее открытого, при помощи функции FileOpen(...), бинарного файла.
Возвращаемое значение
true – в случае успешного завершения, false – в случае ошибки.
Пример:
//--- example for CArray::Load(...)
#include <Arrays\Array.mqh>
//---
void OnStart()
{
int file_handle;
CArray *array=new CArray;
//---
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);
}
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
942
CArrayChar
Класс CArrayChar является классом динамического массива переменных типа char или uchar.
Описание
Класс CArrayChar обеспечивает возможность работы с динамическим массивом переменных типа
char или uchar. В классе реализованы возможности добавления/вставки/удаления элементов
массива, сортировки массива, поисков в сортированном массиве. Кроме того, реализованы
методы работы с файлом.
Декларация
class CArrayChar : public CArray
Заголовок
#include <Arrays\ArrayChar.mqh>
Методы класса по группам
Управление памятью
Reserve
Резервирует память для увеличения размеров
массива
Resize
Устанавливает новый (меньший) размер
массива
Shutdown
Очищает массив с полным освобождением
памяти
Наполнение
Add
Добавляет элемент в конец массива
AddArray
Добавляет в конец массива элементы из
другого массива
AddArray
Добавляет в конец массива элементы из
другого массива
Insert
Вставляет элемент в массив в указанную
позицию
InsertArray
Вставляет в массив элементы из другого
массива с указанной позиции
InsertArray
Вставляет в массив элементы из другого
массива с указанной позиции
AssignArray
Копирует в массив элементы из другого
массива
AssignArray
Копирует в массив элементы из другого
массива
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
943
Изменение
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.
944
Reserve
Резервирует память для увеличения размеров массива.
bool Reserve(
int size // количество
)
Параметры
size
[in] Количество дополнительных элементов массива.
Возвращаемое значение
true в случае успеха, false – если была попытка запросить количество меньше или равное нулю,
либо если массив увеличить не удалось.
Примечание
Для уменьшения фрагментации памяти, приращение размеров массива производится с шагом
ранее заданным через метод Step(int), либо 16 (по умолчанию).
Пример:
//--- example for CArrayChar::Reserve(int)
#include <Arrays\ArrayChar.mqh>
//---
void OnStart()
{
CArrayChar *array=new CArrayChar;
//---
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.
945
Resize
Устанавливает новый (меньший) размер массива.
bool Resize(
int size // размер
)
Параметры
size
[in] Новый размер массива.
Возвращаемое значение
true в случае успеха, false – если была попытка установить размер меньше или равный нулю.
Примечание
Изменение размера массива позволяет оптимально использовать память. Лишние элементы
справа теряются. Для уменьшения фрагментации памяти, изменение размеров массива
производится с шагом ранее заданным через метод Step(int), либо 16 (по умолчанию).
Пример:
//--- example for CArrayChar::Resize(int)
#include <Arrays\ArrayChar.mqh>
//---
void OnStart()
{
CArrayChar *array=new CArrayChar;
//---
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.
946
Shutdown
Очищает массив с полным освобождением памяти.
bool Shutdown()
Возвращаемое значение
true в случае успеха, false – если произошла ошибка.
Пример:
//--- example for CArrayChar::Shutdown()
#include <Arrays\ArrayChar.mqh>
//---
void OnStart()
{
CArrayChar *array=new CArrayChar;
//---
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.
947
Add
Добавляет элемент в конец массива.
bool Add(
char element // элемент для добавления
)
Параметры
element
[in] Значение элемента для добавления в массив.
Возвращаемое значение
true в случае успеха, false – если нет возможности добавить элемент.
Пример:
//--- example for CArrayChar::Add(char)
#include <Arrays\ArrayChar.mqh>
//---
void OnStart()
{
CArrayChar *array=new CArrayChar;
//---
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.
948
AddArray
Добавляет в конец массива элементы из другого массива.
bool AddArray(
const char& src[] // массив-источник
)
Параметры
src[]
[in] Ссылка на массив-источник элементов для добавления.
Возвращаемое значение
true в случае успеха, false – если нет возможности добавить элементы.
Пример:
//--- example for CArrayChar::AddArray(const char &[])
#include <Arrays\ArrayChar.mqh>
//---
char src[];
//---
void OnStart()
{
CArrayChar *array=new CArrayChar;
//---
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;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
949
AddArray
Добавляет в конец массива элементы из другого массива.
bool AddArray(
const CArrayChar* src // указатель на источник
)
Параметры
src
[in] Указатель на экземпляр класса CArrayChar-источник элементов для добавления.
Возвращаемое значение
true в случае успеха, false – если нет возможности добавить элементы.
Пример:
//--- example for CArrayChar::AddArray(const CArrayChar*)
#include <Arrays\ArrayChar.mqh>
//---
void OnStart()
{
CArrayChar *array=new CArrayChar;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- create source array
CArrayChar *src=new CArrayChar;
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;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
950
Insert
Вставляет элемент в массив в указанную позицию.
bool Insert(
char element, // элемент для вставки
int pos // позиция
)
Параметры
element
[in] Значение элемента для вставки в массив
pos
[in] Позиция в массиве для вставки
Возвращаемое значение
true в случае успеха, false – если нет возможности вставить элемент.
Пример:
//--- example for CArrayChar::Insert(char,int)
#include <Arrays\ArrayChar.mqh>
//---
void OnStart()
{
CArrayChar *array=new CArrayChar;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- insert elements
for(int i=0;i<100;i++)
{
if(!array.Insert(i,0))
{
printf("Insert error");
delete array;
return;
}
}
//--- use array
//--- . . .
//--- delete array
delete array;
}