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

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

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

421

enum interval // перечисление именованных констант

{

month=1, // интервал в один месяц

two_months, // два месяца

quarter, // три месяца - квартал

halfyear=6, // полугодие

year=12, // год - 12 месяцев

};

//+------------------------------------------------------------------+

//| Script program start function |

//+------------------------------------------------------------------+

void OnStart()

{

//--- установим временной интервал равным месяцу

interval period=month;

Print(EnumToString(period)+"="+IntegerToString(period));

//--- установим временной интервал равным кварталу (три месяца))

period=quarter;

Print(EnumToString(period)+"="+IntegerToString(period));

//--- установим временной интервал равным году (12 месяцев))

period=year;

Print(EnumToString(period)+"="+IntegerToString(period));

//--- проверим как выводится тип ордера

ENUM_ORDER_TYPE type=ORDER_TYPE_BUY;

Print(EnumToString(type)+"="+IntegerToString(type));

//--- проверим как выводится невернное значение

type=WRONG_VALUE;

Print(EnumToString(type)+"="+IntegerToString(type));

// Результат выполнения:

// month=1

// quarter=3

// year=12

// ORDER_TYPE_BUY=0

// ENUM_ORDER_TYPE::-1=-1

}

Смотри также

Перечисления, Input переменные

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

422

IntegerToString

Преобразует значение целого типа в строку указанной длины и возвращает полученную строку.

string IntegerToString(

long number, // число

int str_len=0, // длина строки на выходе

ushort fill_symbol=' ' // заполнитель

);

Параметры

number

[in] Число для преобразования.

str_len=0

[in] Длина строки. Если длина полученной строки окажется больше указанной, то строка не

усекается. Если длина полученной строки окажется меньше, то полученная строка будет

дополнена слева символом-заполнителем.

fill_symbol=' '

[in] Символ-заполнитель. По умолчанию – пробел.

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

Строка.

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

423

ShortToString

Преобразует код символа (unicode) в односимвольную строку и возвращает полученную строку.

string ShortToString(

ushort symbol_code // символ

);

Параметры

symbol_code

[in] Код символа. Вместо кода символа можно использовать литеральную строку,

содержащую символ, либо литеральную строку с двухбайтовым шестнадцатиричным кодом,

соответствующему символу из таблицы Unicode.

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

Строка.

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

424

ShortArrayToString

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

string ShortArrayToString(

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

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

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

);

Параметры

array[]

[in] Массив типа ushort (аналог типа wchar_t).

start=0

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

count=-1

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

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

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

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

Строка.

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

425

TimeToString

Преобразование значения, содержащего время в секундах, прошедшее с 01.01.1970, в строку

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

string TimeToString(

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

int mode=TIME_DATE|TIME_MINUTES // формат вывода

);

Параметры

value

[in] Время в секундах от 00:00 1 января 1970.

mode=TIME_DATE|TIME_MINUTES

[in] Дополнительный режим вывода данных. Может быть одним или комбинированным

флагом: TIME_DATE получает результат в форме " yyyy.mm.dd " , TIME_MINUTES получает

результат в форме " hh:mi " , TIME_SECONDS получает результат в форме " hh:mi:ss ".

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

Строка.

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

426

NormalizeDouble

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

double NormalizeDouble(

double value, // нормализуемое число

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

);

Параметры

value

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

digits

[in] Формат точности, число цифр после десятичной точки (0-8).

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

Значение типа double с заданной точностью.

Примечание

Рассчитываемые значения StopLoss, TakeProfit, а также значения цены открытия отложенных

ордеров, должны быть нормализованы с точностью, значение которой можно получить

функцией Digits().

Пример:

double pi=M_PI;

Print("pi=",DoubleToString(pi,16));

double pi_3=NormalizeDouble(M_PI,3);

Print("NormalizeDouble(pi,3) = ",DoubleToString(pi_3,16))

;

double pi_8=NormalizeDouble(M_PI,8);

Print("NormalizeDouble(pi,8) = ",DoubleToString(pi_8,16));

double pi_0=NormalizeDouble(M_PI,0);

Print("NormalizeDouble(pi,0) = ",DoubleToString(pi_0,16));

Результат:

pi= 3.1415926535897931

NormalizeDouble(pi,3)= 3.1419999999999999

NormalizeDouble(pi,8)= 3.1415926499999998

NormalizeDouble(pi,0)= 3.0000000000000000

Смотри также

DoubleToString, Вещественныетипы(double,float), Приведениетипов,

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

427

StringToCharArray

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

uchar. Функция возвращает количество скопированных элементов.

int StringToCharArray(

string text_string, // строка-источник

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

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

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

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

);

Параметры

text_string

[in] Строка для копирования.

array[]

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

start=0

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

count=-1

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

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

терминального 0. Терминальный 0 также будет скопирован в массив-приемник, при этом

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

Если размер динамического массива больше длины строки, то размер массива уменьшен не

будет.

codepage=CP_ACP

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

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

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

Количество скопированных элементов.

Смотри также

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

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

428

StringToColor

Преобразует строку типа "R,G,B" или строку, содержащую наименование цвета, в значение типа

color.

color StringToColor(

string color_string // строковое представление цвета

);

Параметры

color_string

[in] Строковое представление цвета типа "R,G,B" или название одного из предопределенных

Web-цветов.

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

Значение цвета.

Пример:

color str_color=StringToColor("0,127,0");

Print(str_color);

Print((string)str_color);

//--- немного изменим цвет

str_color=StringToColor("0,128,0");

Print(str_color);

Print((string)str_color);

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

429

StringToDouble

Преобразование строки, содержащей символьное представление числа, в число типа double.

double StringToDouble(

string value // строка

);

Параметры

value

[in] Строка, содержащая символьное представление числа.

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

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

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

430

StringToInteger

Преобразование строки, содержащей символьное представление числа, в число типа int (целое).

long StringToInteger(

string value // строка

);

Параметры

value

[in] Строка, содержащая число.

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

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