Справочник по языку программирования MQL5
Подождите немного. Документ загружается.
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1151
AssignArray
Копирует в массив элементы из другого массива.
bool AssignArray(
const string& src[] // массив-источник
)
Параметры
src[]
[in] Ссылка на массив-источник элементов для копирования.
Возвращаемое значение
true в случае успеха, false – если нет возможности скопировать элементы.
Пример:
//--- example for CArrayString::AssignArray(const string &[])
#include <Arrays\ArrayString.mqh>
//---
string src[];
//---
void OnStart()
{
CArrayString *array=new CArrayString;
//---
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.
1152
AssignArray
Копирует в массив элементы из другого массива.
bool AssignArray(
const CArrayString* src // указатель на источник
)
Параметры
src
[in] Указатель на экземпляр класса CArrayString – источник элементов для копирования.
Возвращаемое значение
true в случае успеха, false – если нет возможности скопировать элементы.
Пример:
//--- example for CArrayString::AssignArray(const CArrayString*)
#include <Arrays\ArrayString.mqh>
//---
void OnStart()
{
CArrayString *array=new CArrayString;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- create source array
CArrayString *src =new CArrayString;
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.
1153
Update
Изменяет элемент в указанной позиции массива.
bool Update(
int pos, // позиция
string element // значение
)
Параметры
pos
[in] Позиция элемента в массиве для изменения
element
[in] Новое значение элемента
Возвращаемое значение
true в случае успеха, false – если нет возможности изменить элемент.
Пример:
//--- example for CArrayString::Update(int, string)
#include <Arrays\ArrayString.mqh>
//---
void OnStart()
{
CArrayString *array=new CArrayString;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
//--- update element
if(!array.Update(0,"ABC"))
{
printf("Update error");
delete array;
return;
}
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1154
Shift
Перемещает элемент из указанной позиции массива на указанное смещение.
bool Shift(
int pos, // позиция
int shift // смещение
)
Параметры
pos
[in] Позиция перемещаемого элемента массиве
shift
[in] Значение смещения (как положительное, так и отрицательное значение).
Возвращаемое значение
true в случае успеха, false – если нет возможности переместить элемент.
Пример:
//--- example for CArrayString::Shift(int,int)
#include <Arrays\ArrayString.mqh>
//---
void OnStart()
{
CArrayString *array=new CArrayString;
//---
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.
1155
Delete
Удаляет элемент из указанной позиции массива.
bool Delete(
int pos // позиция
)
Параметры
pos
[in] Позиция удаляемого элемента в массиве.
Возвращаемое значение
true в случае успеха, false – если нет возможности удалить элемент.
Пример:
//--- example for CArrayString::Delete(int)
#include <Arrays\ArrayString.mqh>
//---
void OnStart()
{
CArrayString *array=new CArrayString;
//---
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;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1156
DeleteRange
Удаляет группу элементов из указанной позиции массива.
bool DeleteRange(
int from, // позиция первого элемента
int to // позиция последнего элемента
)
Параметры
from
[in] Позиция первого удаляемого элемента в массиве.
to
[in] Позиция последнего удаляемого элемента в массиве.
Возвращаемое значение
true в случае успеха, false – если нет возможности удалить элементы.
Пример:
//--- example for CArrayString::DeleteRange(int,int)
#include <Arrays\ArrayString.mqh>
//---
void OnStart()
{
CArrayString *array=new CArrayString;
//---
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.
1157
At
Получает элемент из указанной позиции массива.
string At(
int pos // позиция
) const
Параметры
pos
[in] Позиция искомого элемента в массиве.
Возвращаемое значение
Значение элемента в случае успеха, ""– если была попытка получить элемент из не
существующей позиции (при этом код последней ошибки ERR_OUT_OF_RANGE).
Примечание
Разумеется, "" может быть и валидным значением элемента массива, поэтому, получив такое
значение, всегда проверяйте код последней ошибки.
Пример:
//--- example for CArrayString::At(int)
#include <Arrays\ArrayString.mqh>
//---
void OnStart()
{
CArrayString *array=new CArrayString;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
for(int i=0;i<array.Total();i++)
{
string result=array.At(i);
if(result=="" && GetLastError()==ERR_OUT_OF_RANGE)
{
//--- ошибка чтения из массива
printf("Get element error");
delete array;
return;
}
//--- use element
//--- . . .
}
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1158
CompareArray
Сравнивает массив с другим массивом.
bool CompareArray(
const string& src[] // массив-источник
) const
Параметры
src[]
[in] Ссылка на массив-источник элементов для сравнения.
Возвращаемое значение
true в случае массивы равны, false – если нет.
Пример:
//--- example for CArrayString::CompareArray(const string &[])
#include <Arrays\ArrayString.mqh>
//---
string src[];
//---
void OnStart()
{
CArrayString *array=new CArrayString;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- compare with another array
int result=array.CompareArray(src);
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1159
CompareArray
Сравнивает массив с другим массивом.
bool CompareArrays(
const CArrayString* src // указатель на источник
) const
Параметры
src
[in] Указатель на экземпляр класса CArrayString – источник элементов для сравнения.
Возвращаемое значение
true в случае массивы равны, false – если нет.
Пример:
//--- example for CArrayString::CompareArray(const CArrayString*)
#include <Arrays\ArrayString.mqh>
//---
void OnStart()
{
CArrayString *array=new CArrayString;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- create source array
CArrayString *src=new CArrayString;
if(src==NULL)
{
printf("Object create error");
delete array;
return;
}
//--- add source arrays elements
//--- . . .
//--- compare with another array
int result=array.CompareArray(src);
//--- delete arrays
delete src;
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1160
InsertSort
Вставляет элемент в сортированный массив.
bool InsertSort(
string element // элемент для вставки
)
Параметры
element
[in] Значение элемента для вставки в сортированный массив
Возвращаемое значение
true в случае успеха, false – если нет возможности вставить элемент.
Пример:
//--- example for CArrayString::InsertSort(string)
#include <Arrays\ArrayString.mqh>
//---
void OnStart()
{
CArrayString *array=new CArrayString;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
//--- sort array
array.Sort();
//--- insert element
if(!array.InsertSort("ABC"))
{
printf("Insert error");
delete array;
return;
}
//--- delete array
delete array;
}