Справочник по языку программирования MQL5
Подождите немного. Документ загружается.
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
991
DeleteRange
Удаляет группу элементов из указанной позиции массива.
bool DeleteRange(
int from, // позиция первого элемента
int to // позиция последнего элемента
)
Параметры
from
[in] Позиция первого удаляемого элемента в массиве.
to
[in] Позиция последнего удаляемого элемента в массиве.
Возвращаемое значение
true в случае успеха, false – если нет возможности удалить элементы.
Пример:
//--- example for CArrayShort::DeleteRange(int,int)
#include <Arrays\ArrayShort.mqh>
//---
void OnStart()
{
CArrayShort *array=new CArrayShort;
//---
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.
992
At
Получает элемент из указанной позиции массива.
short At(
int pos // позиция
) const
Параметры
pos
[in] Позиция искомого элемента в массиве.
Возвращаемое значение
Значение элемента в случае успеха, SHORT_MAX– если была попытка получить элемент из не
существующей позиции (при этом код последней ошибки ERR_OUT_OF_RANGE).
Примечание
Разумеется, SHORT_MAX может быть и валидным значением элемента массива, поэтому,
получив такое значение, всегда проверяйте код последней ошибки.
Пример:
//--- example for CArrayShort::At(int)
#include <Arrays\ArrayShort.mqh>
//---
void OnStart()
{
CArrayShort *array=new CArrayShort;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
for(int i=0;i<array.Total();i++)
{
short result=array.At(i);
if(result==SHORT_MAX && GetLastError()==ERR_OUT_OF_RANGE)
{
//--- ошибка чтения из массива
printf("Get element error");
delete array;
return;
}
//--- use element
//--- . . .
}
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
993
CompareArray
Сравнивает массив с другим массивом.
bool CompareArray(
const short& src[] // массив-источник
) const
Параметры
src[]
[in] Ссылка на массив-источник элементов для сравнения.
Возвращаемое значение
true в случае массивы равны, false – если нет.
Пример:
//--- example for CArrayShort::CompareArray(const short &[])
#include <Arrays\ArrayShort.mqh>
//---
short src[];
//---
void OnStart()
{
CArrayShort *array=new CArrayShort;
//---
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.
994
CompareArray
Сравнивает массив с другим массивом.
bool CompareArray(
const CArrayShort* src // указатель на источник
) const
Параметры
src
[in] Указатель на экземпляр класса CArrayShort-источник элементов для сравнения.
Возвращаемое значение
true в случае массивы равны, false – если нет.
Пример:
//--- example for CArrayShort::CompareArray(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
//--- . . .
//--- compare with another array
int result=array.CompareArray(src);
//--- delete arrays
delete src;
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
995
InsertSort
Вставляет элемент в сортированный массив.
bool InsertSort(
short element // элемент для вставки
)
Параметры
element
[in] Значение элемента для вставки в сортированный массив
Возвращаемое значение
true в случае успеха, false – если нет возможности вставить элемент.
Пример:
//--- example for CArrayShort::InsertSort(short)
#include <Arrays\ArrayShort.mqh>
//---
void OnStart()
{
CArrayShort *array=new CArrayShort;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
//--- sort array
array.Sort();
//--- insert element
if(!array.InsertSort(100))
{
printf("Insert error");
delete array;
return;
}
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
996
Search
Ищет элемент равный образцу в сортированном массиве.
int Search(
short element // образец
) const
Параметры
element
[in] Образец элемента для поиска в массиве.
Возвращаемое значение
Позиция найденного элемента в случае успеха, -1 – если элемент не найден.
Пример:
//--- example for CArrayShort::Search(short)
#include <Arrays\ArrayShort.mqh>
//---
void OnStart()
{
CArrayShort *array=new CArrayShort;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
//--- sort array
array.Sort();
//--- search element
if(array.Search(100)!=-1) printf("Element found");
else printf("Element not found");
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
997
SearchGreat
Ищет элемент больше образца в сортированном массиве.
int SearchGreat(
short element // образец
) const
Параметры
element
[in] Образец элемента для поиска в массиве.
Возвращаемое значение
Позиция найденного элемента в случае успеха, -1 – если элемент не найден.
Пример:
//--- example for CArrayShort::SearchGreat(short)
#include <Arrays\ArrayShort.mqh>
//---
void OnStart()
{
CArrayShort *array=new CArrayShort;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
//--- sort array
array.Sort();
//--- search element
if(array.SearchGreat(100)!=-1) printf("Element found");
else printf("Element not found");
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
998
SearchLess
Ищет элемент меньше образца в сортированном массиве.
int SearchLess(
short element // образец
) const
Параметры
element
[in] Образец элемента для поиска в массиве.
Возвращаемое значение
Позиция найденного элемента в случае успеха, -1 – если элемент не найден.
Пример:
//--- example for CArrayShort::SearchLess(short)
#include <Arrays\ArrayShort.mqh>
//---
void OnStart()
{
CArrayShort *array=new CArrayShort;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
//--- sort array
array.Sort();
//--- search element
if(array.SearchLess(100)!=-1) printf("Element found");
else printf("Element not found");
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
999
SearchGreatOrEqual
Ищет элемент больше или равный образцу в сортированном массиве.
int SearchGreatOrEqual(
short element // образец
) const
Параметры
element
[in] Образец элемента для поиска в массиве.
Возвращаемое значение
Позиция найденного элемента в случае успеха, -1 – если элемент не найден.
Пример:
//--- example for CArrayShort::SearchGreatOrEqual(short)
#include <Arrays\ArrayShort.mqh>
//---
void OnStart()
{
CArrayShort *array=new CArrayShort;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
//--- sort array
array.Sort();
//--- search element
if(array.SearchGreatOrEqual(100)!=-1) printf("Element found");
else printf("Element not found");
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1000
SearchLessOrEqual
Ищет элемент меньше или равный образцу в сортированном массиве.
int SearchLessOrEqual(
short element // образец
) const
Параметры
element
[in] Образец элемента для поиска в массиве.
Возвращаемое значение
Позиция найденного элемента в случае успеха, -1 – если элемент не найден.
Пример:
//--- example for CArrayShort::SearchLessOrEqual(short)
#include <Arrays\ArrayShort.mqh>
//---
void OnStart()
{
CArrayShort *array=new CArrayShort;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
//--- sort array
array.Sort();
//--- search element
if(array.SearchLessOrEqual(100)!=-1) printf("Element found");
else printf("Element not found");
//--- delete array
delete array;
}