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

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

Математические функции

451

MathSin

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

double MathSin(

double value // аргумент в радианах

);

Параметры

value

[in] Угол в радианах.

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

Синус угла, указанного в радианах. Возвращает значение в диапазоне от -1 до 1.

Примечание

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

Математические функции

452

MathSqrt

Возвращает квадратный корень числа.

double MathSqrt(

double value // положительное число

);

Параметры

value

[in] Положительная числовая величина.

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

Квадратный корень числа value. Если value отрицательно, MathSqrt возвращает NaN

(неопределенное значение).

Примечание

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

Смотри также

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

Математические функции

453

MathSrand

Устанавливает начальное состояние для генерации ряда псевдослучайных целых чисел.

void MathSrand(

int seed // инициализирующее число

);

Параметры

seed

[in] Начальное число для ряда случайных чисел.

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

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

Примечание

Чтобы переинициализировать генератор (т.е. установить генератор в предыдущее начальное

состояние), необходимо использовать значение 1 в качестве инициализирующего параметра.

Любое другое значение для начального числа устанавливает генератор в случайную отправную

точку.

MathRand возвращает подряд сгенерированные псевдослучайные числа. Вызов MathRand перед

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

с параметром 1.

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

Математические функции

454

MathTan

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

double MathTan(

double rad // аргумент в радианах

);

Параметры

rad

[in] Угол в радианах.

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

Тангенс числа rad. Если rad больше или равен 263 или меньше или равен -263, то происходит

потеря значения и функция возвращает неопределенное число.

Примечание

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

Смотри также

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

Математические функции

455

MathIsValidNumber

Проверяет корректность действительного числа

bool MathIsValidNumber(

double number // число для проверки

);

Параметры

number

[in] Проверяемое число.

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

Возвращает true, если проверяемое значение является допустимым вещественным числом. Если

проверяемое значение является плюс или минус бесконечностью, либо "не числом" (NaN - not a

number), функция возвращает false.

Пример:

double abnormal=MathArcsin(2.0);

if(!MathIsValidNumber(abnormal)) Print("Внимание! MathArcsin(2.0) = ",abnormal);

Смотри также

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

Строковые функции

456

Строковые функции

Группа функций, предназначенных для работы с данными типа string.

Функция

Действие

StringAdd

Добавляет строку по месту указанной

подстрокой

StringBufferLen

Возвращает размер буфера, распределенного

для строки.

StringCompare

Сравнивает две строки и возвращает 1, если

первое строка больше второй; 0 - если строки

равны; -1 (минус один) - если первая строка

меньше второй

StringConcatenate

Формирует строку из переданных параметров

StringFill

Заполняет указанную строку по месту

указанными символами

StringFind

Поиск подстроки в строке

StringGetCharacter

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

расположенного в указанной позиции строки

StringInit

Инициализирует строку указанными

символами и обеспечивает указанный размер

строки

StringLen

Возвращает число символов в строке

StringReplace

Заменяет в строке все найденные подстроки

на заданную последовательность символов.

StringSetCharacter

Возвращает копию строки с измененным

значением символа в указанной позиции

StringSubstr

Извлекает подстроку из текстовой строки,

начинающейся c указанной позиции

StringToLower

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

строчные (маленькие) по месту

StringToUpper

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

прописные (большие) по месту

StringTrimLeft

Удаляет символы перевода каретки, пробелы

и символы табуляции с начала строки

StringTrimRight

Удаляет символы перевода каретки, пробелы

и символы табуляции в конце строки

Строковые функции

457

StringAdd

Присоединяет к концу строки по месту указанную подстроку.

bool StringAdd(

string& string_var, // строка, к которой добавляем

string add_substring // добавляемая строка

);

Параметры

string_var

[in][out] Строка, которая будет дополнена.

add_substring

[in] Строка, которая будет добавлена в конец исходной строки.

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

В случае успешного выполнения возвращает true, иначе false. Для получения кода ошибки

нужно вызвать функцию GetLastError().

Примечание

Функция StringAdd() работает быстрее и экономнее по памяти, чем связывание строк при

помощи операций сложения.

Пример:

Строковые функции

458

void OnStart()

{

string a="a",b="b",c;

//--- первый способ

int start=GetTickCount(),stop;

long i;

for(i=0;i<length;i++)

{

c=a+b;

}

stop=GetTickCount();

Print("time for 'c = a + b' = ",(stop-start)," milliseconds, i = ",i);

//--- второй способ

start=GetTickCount();

for(i=0;i<length;i++)

{

StringAdd(a,b);

}

stop=GetTickCount();

Print("time for 'StringAdd(a,b)' = ",(stop-start)," milliseconds, i = ",i);

//--- третий способ

start=GetTickCount();

a="a"; // заново инициализируем переменную a

for(i=0;i<length;i++)

{

int k=StringConcatenate(c,a,b);

}

stop=GetTickCount();

Print("time for 'StringConcatenate(c,a,b)' = ",(stop-start)," milliseconds, i = ",i);

}

Смотри также

StringConcatenate

Строковые функции

459

StringBufferLen

Возвращает размер буфера, распределенного для строки.

int StringBufferLen(

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

)

Параметры

string_var

[in] Строка.

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

Значение 0 означает, что строка – константная и содержимое буфера менять нельзя. -1

означает, что строка принадлежит клиентскому терминалу и изменение содержимого буфера

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

Примечание

Минимальный размер буфера равен 16.

Пример:

void OnStart()

{

long length=1000;

string a="a",b="b";

//---

long i;

Print("before: StringBufferLen(a) = ",StringBufferLen(a),

" StringLen(a) = ",StringLen(a));

for(i=0;i<length;i++)

{

StringAdd(a,b);

}

Print("after: StringBufferLen(a) = ",StringBufferLen(a),

" StringLen(a) = +-",StringLen(a));

}

Смотри также

StringAdd, StringInit, StringLen, StringFill

Строковые функции

460

StringCompare

Сравнивает между собой две строки и возвращает результат сравнения в виде целого числа.

int StringCompare(

const string& string1, // первая сравниваемая строка

const string& string2, // вторая сравниваемая строка

bool case_sensitive=true // режим учета регистра букв при сравнении

);

Параметры

string1

[in] Первая строка.

string2

[in] Вторая строка.

case_sensitive=true

[in] Режим учета регистра букв. Если значения равно true, то "A">"a". Если значение равно

false, то "A"="a". По умолчанию значение параметра равно true.

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

-1 (минус один), если string1<string2

0 (ноль), если string1=string2

1 (один), если string1>string2

Примечание

Строки сравниваются посимвольно, символы сравниваются в алфавитном порядке в

соответствии с текущей кодовой страницей.

Пример: