Справочник по языку программирования MQL5
Подождите немного. Документ загружается.
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1221
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1222
Insert
Вставляет элемент в список в указанную позицию.
int Insert(
CObject* element, // элемент для вставки
int pos // позиция
)
Параметры
element
[in] значение элемента для вставки в список
pos
[in] позиция в списке для вставки
Возвращаемое значение
Индекс вставленного элемента, либо -1 в случае ошибки.
Примечание
Элемент не добавится в список, если в качестве параметра передать некорректный указатель
(например NULL).
Пример:
//--- example for CList::Insert(CObject*,int)
#include <Arrays\List.mqh>
//---
void OnStart()
{
CList *list=new CList;
//---
if(list==NULL)
{
printf("Object create error");
return;
}
//--- insert 100 elements
for(int i=0;i<100;i++)
{
if(list.Insert(new CObject,0)==-1)
{
printf("Element insert error");
delete list;
return;
}
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1223
//--- use list
//--- . . .
//--- delete list
delete list;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1224
DetachCurrent
Изымает элемент из текущей позиции списка не удаляя его “физически”.
CObject* DetachCurrent()
Возвращаемое значение
Указатель на изъятый элемент в случае успеха, NULL – если нет возможности изъять элемент.
Примечание
При изъятии из списка, элемент не удалится при любом состоянии флага управления памятью.
Указатель на изъятый из списка элемент небходимо освободить после использования.
Пример:
//--- example for CList::DetachCurrent()
#include <Arrays\List.mqh>
//---
void OnStart()
{
CList *list=new CList;
//---
if(list==NULL)
{
printf("Object create error");
return;
}
//--- add list elements
//--- . . .
CObject *object=list.DetachCurrent();
if(object==NULL)
{
printf("Detach error");
delete list;
return;
}
//--- use element
//--- . . .
//--- delete element
delete object;
//--- delete list
delete list;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1225
DeleteCurrent
Удаляет элемент из текущей позиции списка.
bool DeleteCurrent()
Возвращаемое значение
true в случае успеха, false – если нет возможности удалить элемент.
Примечание
Если включен механизм управления памятью, память удаляемого элемента освобождается.
Пример:
//--- example for CList::DeleteCurrent()
#include <Arrays\List.mqh>
//---
void OnStart()
{
CList *list=new CList;
//---
if(list==NULL)
{
printf("Object create error");
return;
}
//--- add list elements
//--- . . .
if(!list.DeleteCurrent())
{
printf("Delete error");
delete list;
return;
}
//--- delete list
delete list;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1226
Delete
Удаляет элемент из указанной позиции списка.
bool Delete(
int pos // позиция
)
Параметры
pos
[in] позиция удаляемого элемента в списке.
Возвращаемое значение
true в случае успеха, false – если нет возможности удалить элемент.
Примечание
Если включен механизм управления памятью, память удаляемого элемента освобождается.
Пример:
//--- example for CList::Delete(int)
#include <Arrays\List.mqh>
//---
void OnStart()
{
CList *list=new CList;
//---
if(list==NULL)
{
printf("Object create error");
return;
}
//--- add list elements
//--- . . .
if(!list.Delete(0))
{
printf("Delete error");
delete list;
return;
}
//--- delete list
delete list;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1227
Clear
Удаляет все элементы списка.
void Clear()
Примечание
Если включен механизм управления памятью, память удаляемых элементов освобождается.
Пример:
//--- example for CList::Clear()
#include <Arrays\List.mqh>
//---
void OnStart()
{
CList *list=new CList;
//---
if(list==NULL)
{
printf("Object create error");
return;
}
//--- add list elements
//--- . . .
//--- clear list
list.Clear();
//--- delete list
delete list;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1228
IndexOf
Получает индекс указанного элемента списка.
int IndexOf(
CObject* element // указатель на элемент
)
Параметры
element
[in] указатель на элемент списка.
Возвращаемое значение
Индекс элемента списка, либо -1.
Пример:
//--- example for CList::IndexOf(CObject*)
#include <Arrays\List.mqh>
//---
void OnStart()
{
CList *list=new CList;
//---
if(list==NULL)
{
printf("Object create error");
return;
}
CObject *object=new CObject;
if(object==NULL)
{
printf("Element create error");
delete list;
return;
}
if(list.Add(object))
{
int pos=list.IndexOf(object);
}
//--- delete list
delete list;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1229
GetNodeAtIndex
Получает элемент из указанной позиции списка.
CObject* GetNodeAtIndex(
int pos // позиция
)
Параметры
pos
[in] позиция элемента в списке.
Возвращаемое значение
указатель на элемент в случае успеха, NULL – если нет возможности получить указатель.
Пример:
//--- example for CList::GetNodeAtIndex(int)
#include <Arrays\List.mqh>
//---
void OnStart()
{
CList *list=new CList;
//---
if(list==NULL)
{
printf("Object create error");
return;
}
//--- add list elements
//--- . . .
CObject *object=list.GetNodeAtIndex(10);
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.
1230
GetFirstNode
Получает первый элемент списка.
CObject* GetFirstNode()
Возвращаемое значение
Указатель на первый элемент в случае успеха, NULL – если нет возможности получить
указатель.
Пример:
//--- example for CList::GetFirstNode()
#include <Arrays\List.mqh>
//---
void OnStart()
{
CList *list=new CList;
//---
if(list==NULL)
{
printf("Object create error");
return;
}
//--- add list elements
//--- . . .
CObject *object=list.GetFirstNode();
if(object==NULL)
{
printf("Get node error");
delete list;
return;
}
//--- use element
//--- . . .
//--- do not delete element
//--- delete list
delete list;
}