Справочник по языку программирования MQL5
Подождите немного. Документ загружается.
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
931
Step
Получает шаг приращения размеров массива.
int Step() const
Возвращаемое значение
Шаг приращения размеров массива.
Пример:
//--- example for CArray::Step()
#include <Arrays\Array.mqh>
//---
void OnStart()
{
CArray *array=new CArray;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- get resize step
int step=array.Step();
//--- use array
//--- ...
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
932
Step
Устанавливает шаг приращения размеров массива.
bool Step(
int step // шаг
)
Параметры
step
[in] Новое значение шага приращения размеров массива.
Возвращаемое значение
true в случае успеха, false – если была попытка установить шаг меньше или равный нулю.
Пример:
//--- example for CArray::Step(int)
#include <Arrays\Array.mqh>
//---
void OnStart()
{
CArray *array=new CArray;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- set resize step
bool result=array.Step(1024);
//--- use array
//--- ...
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
933
Total
Получает количество элементов в массиве.
int Total() const;
Возвращаемое значение
Количество элементов в массиве.
Пример:
//--- example for CArray::Total()
#include <Arrays\Array.mqh>
//---
void OnStart()
{
CArray *array=new CArray;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- check total
int total=array.Total();
//--- use array
//--- ...
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
934
Available
Получает количество свободных элементов массива, доступных без дополнительного
распределения памяти.
int Available() const
Возвращаемое значение
Количество свободных элементов массива, доступных без дополнительного распределения
памяти.
Пример:
//--- example for CArray::Available()
#include <Arrays\Array.mqh>
//---
void OnStart()
{
CArray *array=new CArray;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- check available
int available=array.Available();
//--- use array
//--- ...
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
935
Max
Получает максимально возможный размер массива без перевыделения памяти.
int Max() const
Возвращаемое значение
Максимально возможный размер массива без перевыделения памяти.
Пример:
//--- example for CArray::Max()
#include <Arrays\Array.mqh>
//---
void OnStart()
{
CArray *array=new CArray;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- check maximum size
int max=array.Max();
//--- use array
//--- ...
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
936
IsSorted
Получает признак сортированности массива по указанному варианту.
bool IsSorted(
int mode=0 // вариант сортировки
) const
Параметры
mode=0
[in] Проверяемый вариант сортировки.
Возвращаемое значение
Флаг сортированности списка. Если список сортированный по указанному варианту ― true, иначе
― false.
Примечание
Признак сортированности массива нельзя изменить непосредственно. Признак сортированности
устанавливается методом Sort() и сбрасывается любыми методами добавления/вставки кроме
InsertSort(...).
Пример:
//--- example for CArray::IsSorted()
#include <Arrays\Array.mqh>
//---
void OnStart()
{
CArray *array=new CArray;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- check sorted
if(array.IsSorted())
{
//--- use methods for sorted array
//--- ...
}
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
937
SortMode
Получает вариант сортировки массива
int SortMode() const;
Возвращаемое значение
Вариант сортировки
Пример:
//--- example for CArray::SortMode()
#include <Arrays\Array.mqh>
//---
void OnStart()
{
CArray *array=new CArray;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- check sort mode
int sort_mode=array.SortMode();
//--- use array
//--- ...
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
938
Clear
Удаляет все элементы массива без освобождения памяти.
void Clear()
Возвращаемое значение
Нет.
Пример:
//--- example for CArray::Clear()
#include <Arrays\Array.mqh>
//---
void OnStart()
{
CArray *array=new CArray;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- use array
//--- ...
//--- clear array
array.Clear();
//--- delete array
delete array;
}
Смотри также
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
939
Sort
Сортирует массив по указанному варианту.
void Sort(
int mode=0 // вариант сортировки
)
Параметры
mode=0
[in] Вариант сортировки массива.
Возвращаемое значение
Нет.
Примечание
Сортировка массива производится всегда по возрастанию. Для массивов простых типов данных
( CArrayChar, CArrayShort и др), параметр mode не используется. Для массива CArrayObj,
мультивариантные сортировки, должны быть реализованы в методе Sort(int) классов-
наследников.
Пример:
//--- example for CArray::Sort(int)
#include <Arrays\Array.mqh>
//---
void OnStart()
{
CArray *array=new CArray;
//---
if(array==NULL)
{
printf("Object create error");
return;
}
//--- sorting by mode 0
array.Sort(0);
//--- use array
//--- ...
//--- delete array
delete array;
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
940
Save
Сохраняет данные массива в файле.
virtual bool Save(
int file_handle // хэндл файла
)
Параметры
file_handle
[in] Хэндл ранее открытого, при помощи функции FileOpen(...), бинарного файла.
Возвращаемое значение
true – в случае успешного завершения, false – в случае ошибки.
Пример:
//--- example for CArray::Save(int)
#include <Arrays\Array.mqh>
//---
void OnStart()
{
int file_handle;
CArray *array=new CArray;
//---
if(array!=NULL)
{
printf("Object create error");
return;
}
//--- 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
delete array;
}