Справочник по языку программирования MQL5
Подождите немного. Документ загружается.
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1231
GetPrevNode
Получает предыдущий элемент списка.
CObject* GetPrevNode()
Возвращаемое значение
Указатель на предыдущий элемент в случае успеха, NULL – если нет возможности получить
указатель.
Пример:
//--- example for CList::GetPrevNode()
#include <Arrays\List.mqh>
//---
void OnStart()
{
CList *list=new CList;
//---
if(list==NULL)
{
printf("Object create error");
return;
}
//--- add list elements
//--- . . .
CObject *object=list.GetPrevNode();
if(object==NULL)
{
printf("Get node error");
delete list;
return;
}
//--- use element
//--- . . .
//--- do not delete element
//--- delete list
delete list;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1232
GetCurrentNode
Получает текущий элемент списка.
CObject* GetCurrentNode()
Возвращаемое значение
Указатель на текущий элемент в случае успеха, NULL – если нет возможности получить
указатель.
Пример:
//--- example for CList::GetCurrentNode()
#include <Arrays\List.mqh>
//---
void OnStart()
{
CList *list=new CList;
//---
if(list==NULL)
{
printf("Object create error");
return;
}
//--- add list elements
//--- . . .
CObject *object=list.GetCurrentNode();
if(object==NULL)
{
printf("Get node error");
delete list;
return;
}
//--- use element
//--- . . .
//--- do not delete element
//--- delete list
delete list;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1233
GetNextNode
Получает следующий элемент списка.
CObject* GetNextNode()
Возвращаемое значение
Указатель на следующий элемент в случае успеха, NULL – если нет возможности получить
указатель.
Пример:
//--- example for CList::GetNextNode()
#include <Arrays\List.mqh>
//---
void OnStart()
{
CList *list=new CList;
//---
if(list==NULL)
{
printf("Object create error");
return;
}
//--- add list elements
//--- . . .
CObject *object=list.GetNextNode();
if(object==NULL)
{
printf("Get node error");
delete list;
return;
}
//--- use element
//--- . . .
//--- do not delete element
//--- delete list
delete list;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1234
GetLastNode
Получает последний элемент списка.
CObject* GetLastNode()
Возвращаемое значение
Указатель на последний элемент в случае успеха, NULL – если нет возможности получить
указатель.
Пример:
//--- example for CList::GetLastNode()
#include <Arrays\List.mqh>
//---
void OnStart()
{
CList *list=new CList;
//---
if(list==NULL)
{
printf("Object create error");
return;
}
//--- add list elements
//--- . . .
CObject *object=list.GetLastNode();
if(object==NULL)
{
printf("Get node error");
delete list;
return;
}
//--- use element
//--- . . .
//--- do not delete element
//--- delete list
delete list;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1235
Sort
Сортирует список.
void Sort(
int mode // вариант сортировки
)
Параметры
mode
[in] Вариант сортировки.
Возвращаемое значение
Нет.
Примечание
Сортировка списка производится всегда по возрастанию.
Пример:
//--- example for CList::Sort(int)
#include <Arrays\List.mqh>
//---
void OnStart()
{
CList *list=new CList;
//---
if(list==NULL)
{
printf("Object create error");
return;
}
//--- sorting by mode 0
list.Sort(0);
//--- use list
//--- ...
//--- delete list
delete list;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1236
MoveToIndex
Перемещает текущий элемент списка в указанную позицию.
bool MoveToIndex(
int pos // позиция
)
Параметры
pos
[in] позиция в списке для перемещения.
Возвращаемое значение
true в случае успеха, false – если нет возможности переместить элемент.
Пример:
//--- example for CList::MoveToIndex(int)
#include <Arrays\List.mqh>
//---
void OnStart()
{
CList *list=new CList;
//---
if(list==NULL)
{
printf("Object create error");
return;
}
//--- move current node to begin
list.MoveToIndex(0);
//--- use list
//--- . . .
//--- delete list
delete list;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1237
Exchange
Меняет элементы списка местами.
bool Exchange(
CObject* node1, // элемент списка
CObject* node2 // элемент списка
)
Параметры
node1
[in] элемент списка
node2
[in] элемент списка
Возвращаемое значение
true в случае успеха, false – если нет возможности поменять элементы местами.
Пример:
//--- example for CList::Exchange(CObject*,CObject*)
#include <Arrays\List.mqh>
//---
void OnStart()
{
CList *list=new CList;
//---
if(list==NULL)
{
printf("Object create error");
return;
}
//--- exchange
list.Exchange(list.GetFirstNode(),list.GetLastNode());
//--- use list
//--- . . .
//--- delete list
delete list;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1238
CompareList
Сравнивает список с другим списком.
bool CompareList(
CList* list // с кем сравниваем
)
Параметры
list
[in] указатель на экземпляр класса CList-источник элементов для сравнения.
Возвращаемое значение
true в случае если списки равны, false – если нет.
Пример:
//--- example for CList::CompareList(const CList*)
#include <Arrays\List.mqh>
//---
void OnStart()
{
CList *list=new CList;
//---
if(list==NULL)
{
printf("Object create error");
return;
}
//--- create source list
CList *src=new CList;
if(src==NULL)
{
printf("Object create error");
delete list;
return;
}
//--- fill source list
//--- . . .
//--- compare with another list
bool result=list.CompareList(src);
//--- delete lists
delete src;
delete list;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1239
Search
Ищет элемент равный образцу, в сортированном списке.
CObject* Search(
CObject* element // образец
)
Параметры
element
[in] образец элемента для поиска в списке.
Возвращаемое значение
Указатель на найденный элемента в случае успеха, NULL – если элемент не найден.
Пример:
//--- example for CList::Search(CObject*)
#include <Arrays\List.mqh>
//---
void OnStart()
{
CList *list=new CList;
//---
if(list==NULL)
{
printf("Object create error");
return;
}
//--- add lists elements
//--- . . .
//--- sort list
list.Sort(0);
//--- create sample
CObject *sample=new CObject;
if(sample==NULL)
{
printf("Sample create error");
delete list;
return;
}
//--- set sample attributes
//--- . . .
//--- search element
if(list.Search(sample)!=NULL) printf("Element found");
else printf("Element not found");
//--- delete list
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1240
delete list;
}