Справочник по языку программирования MQL5

Подождите немного. Документ загружается.

Операции с массивами

411

Смотри также

Доступктаймсериям, ArrayGetAsSeries

Операции с массивами

412

ArraySize

Возвращает количество элементов указанного массива.

int ArraySize(

void array[] // проверяемый массив

);

Параметры

array[]

[in] Массив любого типа.

Возвращаемое значение

Значение типа int.

Примечание

Для одномерного массива значение, возвращаемое функцией ArraySize, равно значению

ArrayRange(array,0).

Операции с массивами

413

ArraySort

Сортирует одномерный числовой массив по возрастанию слева-направо.

bool ArraySort(

number& array[] // массив для сортировки

);

Параметры

array[]

[in][out] Числовой массив для сортировки.

Возвращаемое значение

Возвращает true в случае успеха, иначе false.

Примечание

Массив, помеченный флагом AS_SERIES, сортируется по убыванию.

Преобразование данных

414

Преобразование данных

Группа функций, обеспечивающих преобразование данных из одного формата в данные другого

формата.

Особо следует отметить функцию NormalizeDouble(), которая обеспечивает требуемую точность

представления цены. В торговых операциях нельзя использовать ненормализованные цены, чья

точность превышает требуемую торговым сервером хотя бы на один знак.

Функция

Действие

CharToString

Преобразование кода символа в

односимвольную строку

DoubleToString

Преобразование числового значения в

текстовую строку с указанной точностью

EnumToString

Преобразование значения перечисления

любого типа в строку

NormalizeDouble

Округление числа с плавающей точкой до

указанной точности

StringToDouble

Преобразование строки, содержащей

символьное представление числа, в число

типа double

StringToInteger

Преобразование строки, содержащей

символьное представление числа, в число

типа int

StringToTime

Преобразование строки, содержащей время

и/или дату в формате "yyyy.mm.dd [hh:mi]", в

число типа datetime

TimeToString

Преобразование значения, содержащего

время в секундах, прошедшее с 01.01.1970, в

строку формата "yyyy.mm.dd hh:mi"

IntegerToString

Преобразование значения целого типа в

строку указанной длины

ShortToString

Преобразование код символа (unicode) в

односимвольную строку

ShortArrayToString

Копирует часть массива в строку

StringToShortArray

Посимвольно копирует строку в указанное

место массива типа ushort

CharArrayToString

Преобразует код символа (ansi) в

односимвольную строку

StringToCharArray

Посимвольно копирует преобразованную из

Unicode в ANSI строку в указанное место

массива типа uchar

Преобразование данных

415

ColorToString

Преобразует значение цвета в строку вида "R,

G,B"

StringToColor

Преобразует строку типа "R,G,B" или строку,

содержащую наименование цвета, в значение

типа color

StringFormat

Преобразует число в строку в соответствие с

заданным форматом

Смотри также

Использование кодовой страницы

Преобразование данных

416

CharToString

Преобразование кода символа в односимвольную строку.

string CharToString(

uchar char_code // числовой код символа

);

Параметры

char_code

[in] Код символа ANSI.

Возвращаемое значение

Строка, содержащая символ ANSI.

Преобразование данных

417

CharArrayToString

Копирует и преобразует часть массива типа uchar в возвращаемую строку.

string CharArrayToString(

uchar  array[], // массив

int start=0, // начальная позиция в массиве

int  count=-1 // количество символов

uint codepage=CP_ACP // кодовая страница

);

Параметры

array[]

[in] Массив типа uchar.

start=0

[in] Позиция, с которой начинается копирование. По умолчанию 0.

count=-1

[in] Количество элементов массива для копирования. Определяет длину результатной строки.

По умолчанию -1, что означает копирование до конца массива, либо до встречи

терминального 0.

codepage=CP_ACP

[in] Значение кодовой страницы. Для наиболее употребимых кодовых страниц предусмотрены

соответствующие константы.

Возвращаемое значение

Строка.

Смотри также

Использование кодовой страницы

Преобразование данных

418

ColorToString

Преобразует значение цвета в строку вида "R,G,B".

string ColorToString(

color color_value, // значение цвета

bool color_name // выводить имя цвета или нет

);

Параметры

color_value

[in] Значение цвета в переменной типа color.

color_name

[in] Признак необходимости возвращать имя цвета, в случае, если значение цвета совпадает

с одной из предопределенных цветовыхконстант.

Возвращаемое значение

Строковое представление цвета в виде "R,G,B", где R, G и B представляют собой

преобразованные в строку десятичные константы со значением от 0 до 255. Если задан

параметр color_name=true, то производится попытка преобразовать значение цвета к имени

цвета.

Пример:

string clr=ColorToString(C'0,255,0'); // зеленый цвет

Print(clr);

clr=ColorToString(C'0,255,0',true); // получить цветовую константу

Print(clr);

Преобразование данных

419

DoubleToString

Преобразование числового значения в текстовую строку.

string DoubleToString(

double value, // число

int digits=8 // кол-во знаков после запятой

);

Параметры

value

[in] Величина с плавающей точкой.

digits

[in] Формат точности. Если значение digits лежит в диапазоне от 0 до 16, то будет получено

строковое представление числа с указанным количество знаков после запятой. Если значение

digits лежит в диапазоне от -1 до -16, то будет получено строковое представление числа в

научном формате с указанным количеством знаков после запятой. Во всех остальных случаях

число строковое значение числа будет содержать 8 знаков после запятой.

Возвращаемое значение

Строка, содержащая символьное представление числа в указанном формате точности.

Пример:

Print("DoubleToString(120.0+M_PI) : ",DoubleToString(120.0+M_PI));

Print("DoubleToString(120.0+M_PI,16) : ",DoubleToString(120.0+M_PI,16));

Print("DoubleToString(120.0+M_PI,-16) : ",DoubleToString(120.0+M_PI,-16));

Print("DoubleToString(120.0+M_PI,-1) : ",DoubleToString(120.0+M_PI,-1));

Print("DoubleToString(120.0+M_PI,-20) : ",DoubleToString(120.0+M_PI,-20));

Смотри также

NormalizeDouble, StringToDouble

Преобразование данных

420

EnumToString

Преобразование значения перечисления любого типа в текстовое представление.

string EnumToString(

any_enum value // значение из перечисления любого типа

);

Параметры

value

[in] Значение перечисления любого типа.

Возвращаемое значение

Строка, содержащая текстовое представление значения. Чтобы получить информацию об

ошибке, необходимо вызвать функцию GetLastError().

Примечание

Функция может установить в переменной _LastError следующие значения ошибок:

ERR_INTERNAL_ERROR – ошибка среды выполнения

ERR_NOT_ENOUGH_MEMORY – недостаточно памяти для завершения операции

ERR_INVALID_PARAMETER – невозможно разрешить имя значения перечисления

Пример: