Справочник по языку программирования MQL5
Подождите немного. Документ загружается.
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1181
Clear
Удаляет все элементы массива без освобождения памяти массива.
void Clear()
Возвращаемое значение
Нет.
Примечание
Если включен механизм управления памятью, память удаляемых элементов освобождается.
Пример:
//--- example for CArrayObj::Clear()
#include <Arrays\ArrayObj.mqh>
//---
void OnStart()
{
CArrayObj *array=new CArrayObj;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
//--- clear array
array.Clear();
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1182
Shutdown
Очищает массив с полным освобождением памяти массива (но не элементов).
bool Shutdown()
Возвращаемое значение
true в случае успеха, false – если произошла ошибка.
Примечание
Если включен механизм управления памятью, память удаляемых элементов освобождается.
Пример:
//--- example for CArrayObj::Shutdown()
#include <Arrays\ArrayObj.mqh>
//---
void OnStart()
{
CArrayObj *array=new CArrayObj;
//---
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.
1183
CreateElement
Создает новый элемент массива в указанной позиции.
bool CreateElement(
int index // позиция
)
Параметры
index
[in] Позиция, в которой нужно создать новый элемент.
Возвращаемое значение
true в случае успеха, false – если нет возможности создать элемент.
Примечание
Метод CreateElement(int) в классе CArrayObj всегда возвращает false и не выполняет каких-
либо действий. При необходимости в классе-наследнике, метод CreateElement(int) должен быть
реализован.
Пример:
//--- example for CArrayObj::CreateElement(int)
#include <Arrays\ArrayObj.mqh>
//---
void OnStart()
{
int size=100;
CArrayObj *array=new CArrayObj;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- fill array
array.Reserve(size);
for(int i=0;i<size;i++)
{
if(!array.CreateElement(i))
{
printf("Element create error");
delete array;
return;
}
}
//--- use array
//--- . . .
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1184
Add
Добавляет элемент в конец массива.
bool Add(
CObject* element // элемент для добавления
)
Параметры
element
[in] Значение элемента для добавления в массив.
Возвращаемое значение
true в случае успеха, false – если нет возможности добавить элемент.
Примечание
Элемент не добавится в массив, если в качестве параметра передать некорректный указатель
(например NULL).
Пример:
//--- example for CArrayObj::Add(CObject*)
#include <Arrays\ArrayObj.mqh>
//---
void OnStart()
{
CArrayObj *array=new CArrayObj;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add 100 arrays elements
for(int i=0;i<100;i++)
{
if(!array.Add(new CObject))
{
printf("Element addition error");
delete array;
return;
}
}
//--- use array
//--- . . .
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1185
AddArray
Добавляет в конец массива элементы из другого массива.
bool AddArray(
const CArrayObj * src // указатель на источник
)
Параметры
src
[in] Указатель на экземпляр класса CArrayDouble – источник элементов для добавления.
Возвращаемое значение
true в случае успеха, false – если нет возможности добавить элементы.
Примечание
Добавление элементов из массива в массив фактически является копированием указателей. В
связи с этим, при вызове метода, существует "подводный камень" - возможность существования
указателя на динамический объект более чем в одной переменной.
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1186
//--- example
extern bool make_error;
extern int error;
extern CArrayObj *src;
//--- создаем новый экземпляр CArrayObj
//--- по умолчанию механизм управления памятью в нем включен
CArrayObj *array=new CArrayObj;
//--- добавляем (копируем) элементы из массива-источика
if(array!=NULL)
bool result=array.AddArray(src);
if(make_error)
{
//--- совершаем ошибочные действия
switch(error)
{
case 0:
//--- удаляем массив-источник, не проверив его флаг управления памятью
delete src;
//--- результат:
//--- возможно обращение
//--- по "битому" указателю в массиве-приемнике
break;
case 1:
//--- выключаем механизм управления памятью в массиве-источнике
if(src.FreeMode()) src.FreeMode(false);
//--- но не удаляем массив-источник
//--- результат:
//--- после удаления массива-приемника, возможно обращение
//--- по "битому" указателю в массиве-источнике
break;
case 2:
//--- выключаем механизм управления памятью в массиве-источнике
src.FreeMode(false);
//--- выключаем механизм управления памятью в массиве-приемнике
array.FreeMode(false);
//--- результат:
//--- после завершения программы, получаем "утечку памяти"
break;
}
}
else
{
//--- выключаем механизм управления памятью в массиве-источнике
if(src.FreeMode()) src.FreeMode(false);
//--- удаляем массив-источник
delete src;
//--- результат:
//--- обращение к элементам массива-приемника будет корректным
//--- удаление массива-приемника приведет к удалению его элементов
}
Пример:
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1187
//--- example for CArrayObj::AddArray(const CArrayObj*)
#include <Arrays\ArrayObj.mqh>
//---
void OnStart()
{
CArrayObj *array=new CArrayObj;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- create source array
CArrayObj *src=new CArrayObj;
if(src==NULL)
{
printf("Object create error");
delete array;
return;
}
//--- reset free mode flag
src.FreeMode(false);
//--- fill source array
//--- . . .
//--- add another array
if(!array.AddArray(src))
{
printf("Array addition error");
delete src;
delete array;
return;
}
//--- delete source array without elements
delete src;
//--- use array
//--- . . .
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1188
Insert
Вставляет элемент в массив в указанную позицию.
bool Insert(
CObject* element, // элемент для вставки
int pos // позиция
)
Параметры
element
[in] Значение элемента для вставки в массив
pos
[in] Позиция в массиве для вставки
Возвращаемое значение
true в случае успеха, false – если нет возможности вставить элемент.
Примечание
Элемент не добавится в массив, если в качестве параметра передать некорректный указатель
(например NULL).
Пример:
//--- example for CArrayObj::Insert(CObject*,int)
#include <Arrays\ArrayObj.mqh>
//---
void OnStart()
{
CArrayObj *array=new CArrayObj;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- insert elements
for(int i=0;i<100;i++)
{
if(!array.Insert(new CObject,0))
{
printf("Insert error");
delete array;
return;
}
}
//--- use array
//--- . . .
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1189
InsertArray
Вставляет в массив элементы из другого массива с указанногй позиции.
bool InsertArray(
const CArrayObj* src, // указатель на источник
int pos // позиция
)
Параметры
src
[in] Указатель на экземпляр класса CArrayObj-источник элементов для вставки.
pos
[in] Позиция в массиве для вставки
Возвращаемое значение
true в случае успеха, false – если нет возможности вставить элементы.
Примечание
См. CArrayObj::AddArray(const CArrayObj*).
Пример:
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1190
//--- example for CArrayObj::InsertArray(const CArrayObj*,int)
#include <Arrays\ArrayObj.mqh>
//---
void OnStart()
{
CArrayObj *array=new CArrayObj;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- create source array
CArrayObj *src=new CArrayObj;
if(src==NULL)
{
printf("Object create error");
delete array;
return;
}
//--- reset free mode flag
src.FreeMode(false);
//--- fill source array
//--- . . .
//--- insert another array
if(!array.InsertArray(src,0))
{
printf("Array inserting error");
delete src;
delete array;
return;
}
//--- delete source array without elements
delete src;
//--- use array
//--- . . .
//--- delete array
delete array;
}