Справочник по языку программирования MQL5
Подождите немного. Документ загружается.
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1201
Search
Ищет элемент равный образцу в сортированном массиве.
int Search(
CObject* element // образец
) const
Параметры
element
[in] Образец элемента для поиска в массиве.
Возвращаемое значение
Позиция найденного элемента в случае успеха, -1 – если элемент не найден.
Пример:
//--- example for CArrayObj::Search(CObject*)
#include <Arrays\ArrayObj.mqh>
//---
void OnStart()
{
CArrayObj *array=new CArrayObj;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
//--- sort array
array.Sort();
//--- create sample
CObject *sample=new CObject;
if(sample==NULL)
{
printf("Sample create error");
delete array;
return;
}
//--- set sample attributes
//--- . . .
//--- search element
if(array.Search(sample)!=-1) printf("Element found");
else printf("Element not found");
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1202
SearchGreat
Ищет элемент больше образца в сортированном массиве.
int SearchGreat(
CObject* element // образец
) const
Параметры
element
[in] Образец элемента для поиска в массиве.
Возвращаемое значение
Позиция найденного элемента в случае успеха, -1 – если элемент не найден.
Пример:
//--- example for CArrayObj::SearchGreat(CObject*)
#include <Arrays\ArrayObj.mqh>
//---
void OnStart()
{
CArrayObj *array=new CArrayObj;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
//--- sort array
array.Sort();
//--- create sample
CObject *sample=new CObject;
if(sample==NULL)
{
printf("Sample create error");
delete array;
return;
}
//--- set sample attributes
//--- . . .
//--- search element
if(array.SearchGreat(sample)!=-1) printf("Element found");
else printf("Element not found");
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1203
SearchLess
Ищет элемент меньше образца в сортированном массиве.
int SearchLess(
CObject* element // образец
) const
Параметры
element
[in] Образец элемента для поиска в массиве.
Возвращаемое значение
Позиция найденного элемента в случае успеха, -1 – если элемент не найден.
Пример:
//--- example for CArrayObj:: SearchLess(CObject*)
#include <Arrays\ArrayObj.mqh>
//---
void OnStart()
{
CArrayObj *array=new CArrayObj;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
//--- sort array
array.Sort();
//--- create sample
CObject *sample=new CObject;
if(sample==NULL)
{
printf("Sample create error");
delete array;
return;
}
//--- set sample attributes
//--- . . .
//--- search element
if(array.SearchLess(sample)!=-1) printf("Element found");
else printf("Element not found");
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1204
SearchGreatOrEqual
Ищет элемент больше или равный образцу в сортированном массиве.
int SearchGreatOrEqual(
CObject* element // образец
) const
Параметры
element
[in] Образец элемента для поиска в массиве.
Возвращаемое значение
Позиция найденного элемента в случае успеха, -1 – если элемент не найден.
Пример:
//--- example for CArrayObj::SearchGreatOrEqual(CObject*)
#include <Arrays\ArrayObj.mqh>
//---
void OnStart()
{
CArrayObj *array=new CArrayObj;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
//--- sort array
array.Sort();
//--- create sample
CObject *sample=new CObject;
if(sample==NULL)
{
printf("Sample create error");
delete array;
return;
}
//--- set sample attributes
//--- . . .
//--- search element
if(array.SearchGreatOrEqual(sample)!=-1) printf("Element found");
else printf("Element not found");
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1205
SearchLessOrEqual
Ищет элемент меньше или равный образцу в сортированном массиве.
int SearchLessOrEqual(
CObject* element // образец
) const
Параметры
element
[in] Образец элемента для поиска в массиве.
Возвращаемое значение
Позиция найденного элемента в случае успеха, -1 – если элемент не найден.
Пример:
//--- example for CArrayObj:: SearchLessOrEqual(CObject*)
#include <Arrays\ArrayObj.mqh>
//---
void OnStart()
{
CArrayObj *array=new CArrayObj;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
//--- sort array
array.Sort();
//--- create sample
CObject *sample=new CObject;
if(sample==NULL)
{
printf("Sample create error");
delete array;
return;
}
//--- set sample attributes
//--- . . .
//--- search element
if(array.SearchLessOrEqual(sample)!=-1) printf("Element found");
else printf("Element not found");
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1206
SearchFirst
Ищет первый элемент равный образцу в сортированном массиве.
int SearchFirst(
CObject* element // образец
) const
Параметры
element
[in] Образец элемента для поиска в массиве.
Возвращаемое значение
Позиция найденного элемента в случае успеха, -1 – если элемент не найден.
Пример:
//--- example for CArrayObj::SearchFirst(CObject*)
#include <Arrays\ArrayObj.mqh>
//---
void OnStart()
{
CArrayObj *array=new CArrayObj;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
//--- sort array
array.Sort();
//--- create sample
CObject *sample=new CObject;
if(sample==NULL)
{
printf("Sample create error");
delete array;
return;
}
//--- set sample attributes
//--- . . .
//--- search element
if(array.SearchFirst(sample)!=-1) printf("Element found");
else printf("Element not found");
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1207
SearchLast
Ищет последний элемент равный образцу в сортированном массиве.
int SearchLast(
CObject* element // образец
) const
Параметры
element
[in] Образец элемента для поиска в массиве.
Возвращаемое значение
Позиция найденного элемента в случае успеха, -1 – если элемент не найден.
Пример:
//--- example for CArrayObj:: SearchLast(CObject*)
#include <Arrays\ArrayObj.mqh>
//---
void OnStart()
{
CArrayObj *array=new CArrayObj;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
//--- sort array
array.Sort();
//--- create sample
CObject *sample=new CObject;
if(sample==NULL)
{
printf("Sample create error");
delete array;
return;
}
//--- set sample attributes
//--- . . .
//--- search element
if(array.SearchLast(sample)!=-1) printf("Element found");
else printf("Element not found");
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1208
Save
Сохраняет данные массива в файле.
virtual bool Save(
int file_handle // хэндл файла
)
Параметры
file_handle
[in] Хэндл ранее открытого при помощи функции FileOpen(...) бинарного файла.
Возвращаемое значение
true – в случае успешного завершения, false – в случае ошибки.
Пример:
//--- example for CArrayObj::Save(int)
#include <Arrays\ArrayObj.mqh>
//---
void OnStart()
{
int file_handle;
CArrayObj *array=new CArrayObj;
//---
if(array!=NULL)
{
printf("Object create error");
return;
}
//--- add arrays elements
//--- . . .
//--- open file
file_handle=FileOpen("MyFile.bin",FILE_WRITE|FILE_BIN|FILE_ANSI);
if(file_handle>=0)
{
if(!array.Save(file_handle))
{
//--- file save error
printf("File save: Error %d!",GetLastError());
delete array;
FileClose(file_handle);
//---
return;
}
FileClose(file_handle);
}
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1209
Load
Загружает данные массива из файла.
virtual bool Load(
int file_handle // хэндл файла
)
Параметры
file_handle
[in] Хэндл ранее открытого, при помощи функции FileOpen(...), бинарного файла.
Возвращаемое значение
true – в случае успешного завершения, false – в случае ошибки.
Примечание
При чтении из файла элементов массива, для создания каждого элемента вызывается метод
CArrayObj::CreateElement(int).
Пример:
//--- example for CArrayObj::Load(int)
#include <Arrays\ArrayObj.mqh>
//---
void OnStart()
{
int file_handle;
CArrayObj *array=new CArrayObj;
//---
if(array!=NULL)
{
printf("Object create error");
return;
}
//--- open file
file_handle=FileOpen("MyFile.bin",FILE_READ|FILE_BIN|FILE_ANSI);
if(file_handle>=0)
{
if(!array.Load(file_handle))
{
//--- file load error
printf("File load: Error %d!",GetLastError());
delete array;
FileClose(file_handle);
//---
return;
}
FileClose(file_handle);
}
//--- use arrays elements
//--- . . .
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1210
Type
Получает идентификатор типа массива.
virtual int Type() const
Возвращаемое значение
Идентификатор типа массива (для CArrayObj - 7778).
Пример:
//--- example for CArrayObj::Type()
#include <Arrays\ArrayObj.mqh>
//---
void OnStart()
{
CArrayObj *array=new CArrayObj;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- get array type
int type=array.Type();
//--- delete array
delete array;
}