Referência MQL5Biblioteca PadrãoColeções de dadosCListInsert

Insert

Elemento de inserções na lista na posição determinada.

int  Insert(
   CObject*  element,     // Element to insert
   int       pos          // Position
   )

Parâmetros

element

[in] o valor do elemento a inserir na lista

pos

[in] Posição na lista para inserir

Valor do Retorno

Se com sucesso, retorna o índice do elemento inserido, ou -1 em caso de erro.

Observação

O elemento não é adicionado à lista caso o parâmetro não passe ponteiro válido (isto é, NULL).

Exemplo

//--- 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;
        }
     }
   //--- use list
   //--- . . .
   //--- delete list
   delete list;
  }

Add

DetachCurrent