Справочник по языку программирования MQL5
Подождите немного. Документ загружается.
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
981
AddArray
Добавляет в конец массива элементы из другого массива.
bool AddArray(
const CArrayShort* src // указатель на источник
)
Параметры
src
[in] Указатель на экземпляр класса CArrayShort-источник элементов для добавления.
Возвращаемое значение
true в случае успеха, false – если нет возможности добавить элементы.
Пример:
//--- example for CArrayShort::AddArray(const CArrayShort*)
#include <Arrays\ArrayShort.mqh>
//---
void OnStart()
{
CArrayShort *array=new CArrayShort;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- create source array
CArrayShort *src=new CArrayShort;
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.
982
Insert
Вставляет элемент в массив в указанную позицию.
bool Insert(
short element, // элемент для вставки
int pos // позиция
)
Параметры
element
[in] Значение элемента для вставки в массив
pos
[in] Позиция в массиве для вставки
Возвращаемое значение
true в случае успеха, false – если нет возможности вставить элемент.
Пример:
//--- example for CArrayShort::Insert(short,int)
#include <Arrays\ArrayShort.mqh>
//---
void OnStart()
{
CArrayShort *array=new CArrayShort;
//---
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.
983
InsertArray
Вставляет в массив элементы из другого массива с указанногй позиции.
bool InsertArray(
const short& src[], // массив-источник
int pos // позиция
)
Параметры
src[]
[in] ссылка на массив-источник элементов для вставки
pos
[in] позиция в массиве для вставки
Возвращаемое значение
true в случае успеха, false – если нет возможности вставить элементы.
Пример:
//--- example for CArrayShort::InsertArray(const short &[],int)
#include <Arrays\ArrayShort.mqh>
//---
short src[];
//---
void OnStart()
{
CArrayShort *array=new CArrayShort;
//---
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.
984
InsertArray
Вставляет в массив элементы из другого массива с указанногй позиции.
bool InsertArray(
CArrayShort* src, // указатель на источник
int pos // позиция
)
Параметры
src
[in] Указатель на экземпляр класса CArrayShort-источник элементов для вставки.
pos
[in] Позиция в массиве для вставки
Возвращаемое значение
true в случае успеха, false – если нет возможности вставить элементы.
Пример:
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
985
//--- example for CArrayShort::InsertArray(const CArrayShort*,int)
#include <Arrays\ArrayShort.mqh>
//---
void OnStart()
{
CArrayShort *array=new CArrayShort;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- create source array
CArrayShort *src=new CArrayShort;
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;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
986
AssignArray
Копирует в массив элементы из другого массива.
bool AssignArray(
const short& src[] // массив-источник
)
Параметры
src[]
[in] Ссылка на массив-источник элементов для копирования.
Возвращаемое значение
true в случае успеха, false – если нет возможности скопировать элементы.
Пример:
//--- example for CArrayShort::AssignArray(const short &[])
#include <Arrays\ArrayShort.mqh>
//---
short src[];
//---
void OnStart()
{
CArrayShort *array=new CArrayShort;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- assign another array
if(!array.AssignArray(src))
{
printf("Array assigned error");
delete array;
return;
}
//--- use array
//--- . . .
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
987
AssignArray
Копирует в массив элементы из другого массива.
bool AssignArray(
const CArrayShort* src // указатель на источник
)
Параметры
src
[in] Указатель на экземпляр класса CArrayShort-источник элементов для копирования.
Возвращаемое значение
true в случае успеха, false – если нет возможности скопировать элементы.
Пример:
//--- example for CArrayShort::AssignArray(const CArrayShort*)
#include <Arrays\ArrayShort.mqh>
//---
void OnStart()
{
CArrayShort *array=new CArrayShort;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- create source array
CArrayShort *src =new CArrayShort;
if(src==NULL)
{
printf("Object create error");
delete array;
return;
}
//--- add source arrays elements
//--- . . .
//--- assign another array
if(!array.AssignArray(src))
{
printf("Array assigned error");
delete src;
delete array;
return;
}
//--- arrays is identical
//--- delete source array
delete src;
//--- use array
//--- . . .
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
988
Update
Изменяет элемент в указанной позиции массива.
bool Update(
int pos, // позиция
short element // значение
)
Параметры
pos
[in] Позиция элемента в массиве для изменения
element
[in] Новое значение элемента
Возвращаемое значение
true в случае успеха, false – если нет возможности изменить элемент.
Пример:
//--- example for CArrayShort::Update(int,short)
#include <Arrays\ArrayShort.mqh>
//---
void OnStart()
{
CArrayShort *array=new CArrayShort;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
//--- update element
if(!array.Update(0,100))
{
printf("Update error");
delete array;
return;
}
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
989
Shift
Перемещает элемент из указанной позиции массива на указанное смещение.
bool Shift(
int pos, // позиция
int shift // смещение
)
Параметры
pos
[in] Позиция перемещаемого элемента массиве
shift
[in] Значение смещения (как положительное, так и отрицательное значение).
Возвращаемое значение
true в случае успеха, false – если нет возможности переместить элемент.
Пример:
//--- example for CArrayShort::Shift(int,int)
#include <Arrays\ArrayShort.mqh>
//---
void OnStart()
{
CArrayShort *array=new CArrayShort;
//---
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.
990
Delete
Удаляет элемент из указанной позиции массива.
bool Delete(
int pos // позиция
)
Параметры
pos
[in] Позиция удаляемого элемента в массиве.
Возвращаемое значение
true в случае успеха, false – если нет возможности удалить элемент.
Пример:
//--- example for CArrayShort::Delete(int)
#include <Arrays\ArrayShort.mqh>
//---
void OnStart()
{
CArrayShort *array=new CArrayShort;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
//--- delete element
if(!array.Delete(0))
{
printf("Delete error");
delete array;
return;
}
//--- delete array
delete array;
}