Русский

Справочник MQL4 Получение рыночной информации SymbolInfoString

SymbolInfoString

Возвращает соответствующее свойство указанного символа. Существует 2 варианта функции.

1. Непосредственно возвращает значение свойства.

string  SymbolInfoString(
   string  name,                      // символ
   ENUM_SYMBOL_INFO_STRING  prop_id   // идентификатор свойства
   );

2. Возвращает true или false в зависимости от успешности выполнения функции. В случае успеха значение свойства помещается в приемную переменную, передаваемую по ссылке последним параметром.

bool  SymbolInfoString(
   string  name,                      // символ
   ENUM_SYMBOL_INFO_STRING  prop_id,  // идентификатор свойства
   string& string_var                 // сюда примем значение свойства
   );

Параметры

name

[in]  Имя символа.

prop_id

[in]  Идентификатор свойства символа. Значение может быть одним из значений перечисления ENUM_SYMBOL_INFO_STRING.

string_var

[out]  Переменная типа string, принимающая  значение запрашиваемого свойства. В случае неудачного выполнения информацию об ошибкe можно получить с помощью функции GetLastError():

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

Значение типа string. В случае неудачного выполнения информацию об ошибкe можно получить с помощью функции GetLastError():

  • 4106 – символ не выбран в "Обзоре рынка" (нет в списке доступных),
  • 4051 – неверный идентификатор свойства символа,
  • 4024 – внутренняя ошибка.

Примечание

Если функция используется для получения информации о последнем тике, то лучше использовать SymbolInfoTick(). Вполне возможно, что по данному символу с момента подключения терминала к торговому счету не было еще ни одной котировки. В таком случае запрашиваемое значение будет неопределенным.

В большинстве случаев достаточно использовать функцию SymbolInfoTick(), которая позволяет получить за один вызов значения Ask, Bid, Last, Volume и время прихода последнего тика.

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

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