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

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

Общие функции

381

заданной ширины, то выводимое значение никогда не усекается.

Если в качестве ширины указана звездочка (*), то в списке передаваемых параметров на

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

указания ширины выводимого значения.

precision

Неотрицательное десятичное число, которое определяет точность вывода – количество цифр

после десятичной точки. В отличие от спецификации ширины, спецификация точности может

отсекать часть дробного значения с округлением или без округления.

Для разных форматных типов (type) спецификация точности применяется по-разному.

Типы

Описание

Поведение по умолчанию

a, A

Спецификация точности

указывает количество

знаков после десятичной

точки

Точность по умолчанию – 6.

c, C

Не применяется

d, i, u, o, x, X

Указывает минимальное

число выводимых цифр.

Если количество цифр в

соответствующем параметре

меньше указанной точности,

то выводимое значение

дополняется слева нулями.

Выводимое значение не

обрезается, если количество

выводимых цифр больше

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

Точность по умолчанию – 1.

e, E, f

Указывает число выводимых

цифр после десятичной

точки. Последняя

выводимая цифра

округляется

Точность по умолчанию – 6.

Если указана точность 0 или

дробная часть отсутствует,

то десятичная точка не

выводится.

g, G

Указывает максимальное

число значимых цифр

Выводится 6 значимых

цифр.

s, S

Указывает количество

выводимых символов

строки. Если длина строки

превышает значение

точности, то строка

усекается на выводе

Выводится вся строка

Общие функции

382

h | l | ll | I32 | I64

Спецификации размеров данных, передаваемых в качестве параметра.

Тип параметра

Используемый префикс

Совместный

спецификатор типа

int

l (маленькая L)

d, i, o, x, or X

uint

l (маленькая L)

o, u, x, or X

long

ll (две маленькие L)

d, i, o, x, or X

short

d, i, o, x, or X

ushort

o, u, x, or X

int

I32

d, i, o, x, or X

uint

I32

o, u, x, or X

long

I64

d, i, o, x, or X

ulong

I64

o, u, x, or X

type

Спецификатор типа является единственным обязательным полем для форматированного вывода.

Символ

Тип

Выводной формат

int

Символ типа short (Unicode)

int

Символ типа char (ANSI)

int

Знаковое десятичное целое

int

Знаковое десятичное целое

int

Беззнаковое восьмеричное

целое

int

Беззнаковое десятичное

целое

int

Беззнаковое

шестнадцатиричное целое с

использованием "abcdef"

int

Беззнаковое

шестнадцатиричное целое с

использованием "ABCDEF"

Общие функции

383

double

Вещественное значение в

формате [ – ]d.dddd e [sign]

ddd, где d – одна десятичная

цифра, dddd – одна или

больше десятичных цифр,

ddd – трехзначное число,

определяющее размер

экспоненты, sign – знак плюс

или минус

double

Идентично формату e, за

исключением того, что знак

экспоненты вывоится

большой буквой (E вместо e)

double

Вещественное значение в

формате [ – ]dddd.dddd, где

dddd – одна или больше

десятичных цифр.

Количество выводимых

знаков перед десятичной

точкой зависит от величины

значения числа. Количество

знаков после десятичной

точки зависит от требуемой

точности.

double

Вещественное значение,

выводимое в формате f или

e, в зависимости от того

какой вывод будет

компактнее.

double

Вещественное значение,

выводимое в формате f или

E, в зависимости от того

какой вывод будет

компактнее.

double

Вещественное значение в

формате [−]0xh.hhhh p±dd,

где h.hhhh – мантисса в виде

шестнадцатиричных цифр с

использованием "abcdef", dd

– одна или более цифр

экспоненты. Количество

знаков после запятой

определяется

спецификациейточности

double

Вещественное значение в

формате [−]0xh.hhhh P±dd,

где h.hhhh – мантисса в виде

Общие функции

384

шестнадцатиричных цифр с

использованием "ABCDEF",

dd – одна или более цифр

экспоненты. Количество

знаков после запятой

определяется

спецификациейточности

string

Вывод строки

Вместо функции PrintFormat() можно использовать функцию printf().

Пример:

PrintFormat("Выводиим DBL_MAX в компактной научной форме %e",DBL_MAX);

printf("Выводиим double %.15e",DBL_MAX);

printf("Выводиим double %15e",DBL_MAX);

printf("Выводиим double %15.10e",DBL_MAX);

printf("Выводиим double %15.10f",DBL_MAX);

printf("Выводиим DBL_MAX %e",10);

printf("Выводиим double %d",DBL_MAX);

printf("Выводиим DBL_MAX %s",10);

printf("Выводиим double %s",DBL_MAX);

Смотри также

StringFormat, DoubleToString, Вещественныетипы(double,float)

Общие функции

385

ResetLastError

Устанавливает значение предопределенной переменной _LastError в ноль.

void ResetLastError();

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

Нет возвращаемого значения.

Примечание

Необходимо отметить, что функция GetLastError() не обнуляет переменную _LastError. Обычно

вызов функции ResetLastError() производится перед вызовом функции, после которой

проверяется возникновение ошибки.

Общие функции

386

SetUserError

Устанавливает предопределенную переменную _LastError в значение, равное

ERR_USER_ERROR_FIRST + user_error

void SetUserError(

ushort user_error, // номер ошибки

);

Параметры

user_error

[in] Номер ошибки, устанавливаемый пользователем.

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

Нет возвращаемого значения.

Примечание

После того, как была выставлена ошибка при помощи функции SetUserError(user_error),

функция GetLastError() вернет значение, равное ERR_USER_ERROR_FIRST + user_error.

Пример:

void OnStart()

{

//--- установим номер ошибки 65537=(ERR_USER_ERROR_FIRST +1)

SetUserError(1);

//--- получим код последней ошибки

Print("GetLastError = ",GetLastError());

Результат

GetLastError = 65537

}

Общие функции

387

SendFTP

Посылает файл по адресу, указанному в окне настроек на закладке "Публикация".

bool SendFTP(

string filename, // файл для отсылки по ftp

string ftp_path=NULL // путь для выгрузки на ftp-сервере

);

Параметры

filename

[in] Имя отсылаемого файла.

ftp_path=NULL

[in] Каталог FTP. Если каталог не указан, то используется каталог, описанный в настройках.

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

В случае неудачи возвращает false.

Примечание

Отсылаемый файл должен находиться в папке каталог_терминала\MQL5\files или ее

подпапках. Отсылка не производится, если в настройках не указан адрес FTP и/или пароль

доступа.

Общие функции

388

SendMail

Посылает электронное письмо по адресу, указанному в окне настроек на закладке "Почта".

bool SendMail(

string subject, // заголовок

string some_text // текст письма

);

Параметры

subject

[in] Заголовок письма.

some_text

[in] Тело письма.

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

true – если письмо поставлено в очередь на отсылку, иначе возвращает false.

Примечание

Отсылка может быть запрещена в настройках, также может быть не указан адрес электронной

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

Общие функции

389

Sleep

Функция задерживает выполнение текущего эксперта или скрипта на определенный интервал.

void Sleep(

int milliseconds // интервал

);

Параметры

milliseconds

[in] Интервал задержки в миллисекундах.

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

Нет возвращаемого значения.

Примечание

Функцию Sleep() нельзя вызывать из пользовательских индикаторов, так как индикаторы

выполняются в интерфейсном потоке и не должны его тормозить. В функцию встроена проверка

состояния флага остановки эксперта каждую 0.1 секунды.

Общие функции

390

TerminalClose

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

bool TerminalClose(

int ret_code // код завершения клиентского терминала

);

Параметры

ret_code

[in] Код возврата, возвращаемый процессом клиентского терминала при завершении работы.

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

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

Примечание

Функция TerminalClose() не производит немедленной остановки работы терминала, она просто

посылает терминалу команду на завершение.

В коде советника, вызвавшего TerminalClose(), должны быть сделаны все приготовления для

немедленного завершения работы (например, должны быть штатным образом закрыты все

ранее открытые файлы). Сразу после вызова этой функции должен идти оператор return.

Параметр ret_code позволяет указывать нужный код возврата для анализа причин

программного прекращения работы терминала при его запуске из командной строки.

Пример: