Insert

Inserta el elemento en la lista en la posición especificada.

int  Insert(
   CObject*  element,     // Elemento a insertar
   int       pos          // Posición
   )

Parámetros

element

[in] valor del elemento a insertar en la lista

pos

[in] Posición a insertar en la lista

Valor devuelto

Devuelve el índice del elemento insertado en caso de ejecutarse correctamente; o -1 en caso de error.

Nota

Si el parámetro no contiene un puntero válido (por ejemplo, NULL), entonces el elemento no se añade a la lista.

Ejemplo:

//--- ejemplo de CList::Insert(CObject*,int)
#include <Arrays\List.mqh> 
//--- 
void OnStart() 
  { 
   CList *list=new CList; 
   //--- 
   if(list==NULL
     { 
      printf("Error al crear el objeto"); 
      return
     } 
   //--- inserta 100 elementos 
   for(int i=0;i<100;i++) 
     { 
      if(list.Insert(new CObject,0)==-1) 
        { 
         printf("Error al insertar elemento"); 
         delete list; 
         return
        } 
     } 
   //--- utiliza la lista 
   //--- . . . 
   //--- elimina la lista 
   delete list; 
  }