Справочник по языку программирования MQL5
Подождите немного. Документ загружается.
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1191
AssignArray
Копирует в массив элементы из другого массива.
bool AssignArray(
const CArrayObj* src // указатель на источник
)
Параметры
src
[in] Указатель на экземпляр класса CArrayObj – источник элементов для копирования.
Возвращаемое значение
true в случае успеха, false – если нет возможности скопировать элементы.
Примечание
Если перед вызовом AssignArray массив приемник не пуст, все его элементы будут удалены из
массива и, если установлен флаг управления памятью, память удаленных элементов будет
освобождена. Массив-приемник становится точной копией массива источника. Дополнительно
см. CArrayObj::AddArray(const CArrayObj*).
Пример:
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1192
//--- example for CArrayObj::AssignArray(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
//--- . . .
//--- assign another array
if(!array.AssignArray(src))
{
printf("Array assigned error");
delete src;
delete array;
return;
}
//--- arrays is identical
//--- delete source array without elements
delete src;
//--- use array
//--- . . .
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1193
Update
Изменяет элемент в указанной позиции массива.
bool Update(
int pos, // позиция
CObject* element // значение
)
Параметры
pos
[in] Позиция элемента в массиве для изменения
element
[in] Новое значение элемента
Возвращаемое значение
true в случае успеха, false – если нет возможности изменить элемент.
Примечание
Элемент не изменится, если в качестве параметра передать некорректный указатель (например
NULL). Если включен механизм управления памятью, память замещаемого элемента
освобождается.
Пример:
//--- example for CArrayObj::Update(int,CObject*)
#include <Arrays\ArrayObj.mqh>
//---
void OnStart()
{
CArrayObj *array=new CArrayObj;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
//--- update element
if(!array.Update(0,new CObject))
{
printf("Update error");
delete array;
return;
}
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1194
Shift
Перемещает элемент из указанной позиции массива на указанное смещение.
bool Shift(
int pos, // позиция
int shift // смещение
)
Параметры
pos
[in] Позиция перемещаемого элемента массиве
shift
[in] Значение смещения (как положительное, так и отрицательное значение).
Возвращаемое значение
true в случае успеха, false – если нет возможности переместить элемент.
Пример:
//--- example for CArrayObj::Shift(int,int)
#include <Arrays\ArrayObj.mqh>
//---
void OnStart()
{
CArrayObj *array=new CArrayObj;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
//--- shift element
if(!array.Shift(10,-5))
{
printf("Shift error");
delete array;
return;
}
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1195
Detach
Изымает элемент из указанной позиции массива.
CObject* Detach(
int pos // позиция
)
Параметры
pos
[in] Позиция изымаемого элемента в массиве.
Возвращаемое значение
Указатель на изъятый элемент в случае успеха, NULL – если нет возможности изъять элемент.
Примечание
При изъятии из массива элемент не удалится при любом состоянии флага управления памятью.
Указатель на изъятый из массива элемент небходимо освободить после использования.
Пример:
//--- example for CArrayObj::Detach(int)
#include <Arrays\ArrayObj.mqh>
//---
void OnStart()
{
CArrayObj *array=new CArrayObj;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
CObject *object=array.Detach(0);
if(object==NULL)
{
printf("Detach error");
delete array;
return;
}
//--- use element
//--- . . .
//--- delete element
delete object;
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1196
Delete
Удаляет элемент из указанной позиции массива.
bool Delete(
int pos // позиция
)
Параметры
pos
[in] Позиция удаляемого элемента в массиве.
Возвращаемое значение
true в случае успеха, false – если нет возможности удалить элемент.
Примечание
Если включен механизм управления памятью, память удаляемых элементов освобождается.
Пример:
//--- example for CArrayObj::Delete(int)
#include <Arrays\ArrayObj.mqh>
//---
void OnStart()
{
CArrayObj *array=new CArrayObj;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
if(!array.Delete(0))
{
printf("Delete error");
delete array;
return;
}
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1197
DeleteRange
Удаляет группу элементов из указанной позиции массива.
bool DeleteRange(
int from, // позиция первого элемента
int to // позиция последнего элемента
)
Параметры
from
[in] Позиция первого удаляемого элемента в массиве.
to
[in] Позиция последнего удаляемого элемента в массиве.
Возвращаемое значение
true в случае успеха, false – если нет возможности удалить элементы.
Примечание
Если включен механизм управления памятью, память удаляемых элементов освобождается.
Пример:
//--- example for CArrayObj::DeleteRange(int,int)
#include <Arrays\ArrayObj.mqh>
//---
void OnStart()
{
CArrayObj *array=new CArrayObj;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
//--- delete elements
if(!array.DeleteRange(0,10))
{
printf("Delete error");
delete array;
return;
}
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1198
At
Получает элемент из указанной позиции массива.
CObject* At(
int pos // позиция
)
Параметры
pos
[in] Позиция искомого элемента в массиве.
Возвращаемое значение
Значение элемента в случае успеха, NULL– если была попытка получить элемент из не
существующей позиции.
Пример:
//--- example for CArrayObj::At(int)
#include <Arrays\ArrayObj.mqh>
//---
void OnStart()
{
CArrayObj *array=new CArrayObj;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add elements
//--- . . .
for(int i=0;i<array.Total();i++)
{
CObject *result=array.At(i);
if(result==NULL)
{
//--- ошибка чтения из массива
printf("Get element error");
delete array;
return;
}
//--- use element
//--- . . .
}
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1199
CompareArray
Сравнивает массив с другим массивом.
bool CompareArray(
const CArrayObj* src // указатель на источник
) const
Параметры
src
[in] Указатель на экземпляр класса CArrayObj – источник элементов для сравнения.
Возвращаемое значение
true в случае массивы равны, false – если нет.
Пример:
//--- example for CArrayObj::CompareArray(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;
}
//--- fill source array
//--- . . .
//--- compare with another array
int result=array.CompareArray(src);
//--- delete arrays
delete src;
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1200
InsertSort
Вставляет элемент в сортированный массив.
bool InsertSort(
CObject* element // элемент для вставки
)
Параметры
element
[in] Значение элемента для вставки в сортированный массив
Возвращаемое значение
true в случае успеха, false – если нет возможности вставить элемент.
Примечание
Элемент не добавится в массив, если в качестве параметра передать некорректный указатель
(например NULL).
Пример:
//--- example for CArrayObj::InsertSort(CObject*)
#include <Arrays\ArrayObj.mqh>
//---
void OnStart()
{
CArrayObj *array=new CArrayObj;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
//--- sort array
array.Sort();
//--- insert element
if(!array.InsertSort(new CObject))
{
printf("Insert error");
delete array;
return;
}
//--- delete array
delete array;
}