Справочник по языку программирования MQL5
Подождите немного. Документ загружается.
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1041
Reserve
Резервирует память для увеличения размеров массива.
bool Reserve(
int size // количество
)
Параметры
size
[in] Количество дополнительных элементов массива.
Возвращаемое значение
true в случае успеха, false – если была попытка запросить количество меньше или равное нулю,
либо если массив увеличить не удалось.
Примечание
Для уменьшения фрагментации памяти, приращение размеров массива производится с шагом
ранее заданным через метод Step(int), либо 16 (по умолчанию).
Пример:
//--- example for CArrayLong::Reserve(int)
#include <Arrays\ArrayLong.mqh>
//---
void OnStart()
{
CArrayLong *array=new CArrayLong;
//---
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.
1042
Resize
Устанавливает новый (меньший) размер массива.
bool Resize(
int size // размер
)
Параметры
size
[in] Новый размер массива.
Возвращаемое значение
true в случае успеха, false – если была попытка установить размер меньше или равный нулю.
Примечание
Изменение размера массива позволяет оптимально использовать память. Лишние элементы
справа теряются. Для уменьшения фрагментации памяти, изменение размеров массива
производится с шагом ранее заданным через метод Step(int), либо 16 (по умолчанию).
Пример:
//--- example for CArrayLong::Resize(int)
#include <Arrays\ArrayLong.mqh>
//---
void OnStart()
{
CArrayLong *array=new CArrayLong;
//---
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.
1043
Shutdown
Очищает массив с полным освобождением памяти.
bool Shutdown()
Возвращаемое значение
true в случае успеха, false – если произошла ошибка.
Пример:
//--- example for CArrayLong::Shutdown()
#include <Arrays\ArrayLong.mqh>
//---
void OnStart()
{
CArrayLong *array=new CArrayLong;
//---
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.
1044
Add
Добавляет элемент в конец массива.
bool Add(
long element // элемент для добавления
)
Параметры
element
[in] Значение элемента для добавления в массив.
Возвращаемое значение
true в случае успеха, false – если нет возможности добавить элемент.
Пример:
//--- example for CArrayLong::Add(long)
#include <Arrays\ArrayLong.mqh>
//---
void OnStart()
{
CArrayLong *array=new CArrayLong;
//---
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.
1045
AddArray
Добавляет в конец массива элементы из другого массива.
bool AddArray(
const long& src[] // массив-источник
)
Параметры
src[]
[in] Ссылка на массив-источник элементов для добавления.
Возвращаемое значение
true в случае успеха, false – если нет возможности добавить элементы.
Пример:
//--- example for CArrayLong::AddArray(const long &[])
#include <Arrays\ArrayLong.mqh>
//---
long src[];
//---
void OnStart()
{
CArrayLong *array=new CArrayLong;
//---
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.
1046
AddArray
Добавляет в конец массива элементы из другого массива.
bool AddArray(
const CArrayLong* src // указатель на источник
)
Параметры
src
[in] Указатель на экземпляр класса CArrayLong-источник элементов для добавления.
Возвращаемое значение
true в случае успеха, false – если нет возможности добавить элементы.
Пример:
//--- example for CArrayLong::AddArray(const CArrayLong*)
#include <Arrays\ArrayLong.mqh>
//---
void OnStart()
{
CArrayLong *array=new CArrayLong;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- create source array
CArrayLong *src=new CArrayLong;
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.
1047
Insert
Вставляет элемент в массив в указанную позицию.
bool Insert(
long element, // элемент для вставки
int pos // позиция
)
Параметры
element
[in] Значение элемента для вставки в массив
pos
[in] Позиция в массиве для вставки
Возвращаемое значение
true в случае успеха, false – если нет возможности вставить элемент.
Пример:
//--- example for CArrayLong::Insert(long,int)
#include <Arrays\ArrayLong.mqh>
//---
void OnStart()
{
CArrayLong *array=new CArrayLong;
//---
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;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1048
InsertArray
Вставляет в массив элементы из другого массива с указанногй позиции.
bool InsertArray(
const long& src[], // массив-источник
int pos // позиция
)
Параметры
src[]
[in] Ссылка на массив-источник элементов для вставки
pos
[in] Позиция в массиве для вставки
Возвращаемое значение
true в случае успеха, false – если нет возможности вставить элементы.
Пример:
//--- example for CArrayLong::InsertArray(const long &[],int)
#include <Arrays\ArrayLong.mqh>
//---
long src[];
//---
void OnStart()
{
CArrayLong *array=new CArrayLong;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- insert another array
if(!array.InsertArray(src,0))
{
printf("Array inserting error");
delete array;
return;
}
//--- use array
//--- . . .
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1049
InsertArray
Вставляет в массив элементы из другого массива с указанногй позиции.
bool InsertArray(
CArrayLong* src, // указатель на источник
int pos // позиция
)
Параметры
src
[in] Указатель на экземпляр класса CArrayLong-источник элементов для вставки.
pos
[in] Позиция в массиве для вставки
Возвращаемое значение
true в случае успеха, false – если нет возможности вставить элементы.
Пример:
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1050
//--- example for CArrayLong::InsertArray(const CArrayLong*,int)
#include <Arrays\ArrayLong.mqh>
//---
void OnStart()
{
CArrayLong *array=new CArrayLong;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- create source array
CArrayLong *src=new CArrayLong;
if(src==NULL)
{
printf("Object create error");
delete array;
return;
}
//--- add source arrays elements
//--- . . .
//--- insert another array
if(!array.InsertArray(src,0))
{
printf("Array inserting error");
delete src;
delete array;
return;
}
//--- delete source array
delete src;
//--- use array
//--- . . .
//--- delete array
delete array;
}