Приложения

Приложение А. Функции, константы и структуры RDS

А.5. Сервисные функции и макросы RDS

А.5.10. Загрузка и сохранение данных блока

А.5.10.2. rdsReportTextLoadError – сообщение об ошибке текстового формата

Функция rdsReportTextLoadError добавляет указанное сообщение в общий список сообщений об ошибках при загрузке данных блока в текстовом формате.

  void RDSCALL rdsReportTextLoadErrorA(
    RDSCSTR ErrorMsg  // Сообщение (UTF8)
  );
  void RDSCALL rdsReportTextLoadErrorW(
    RDSWCSTR ErrorMsg // Сообщение (UTF16)
  );
  // Функция-псевдоним
  void RDSCALL rdsReportTextLoadError(
    RDSXCSTR ErrorMsg // Сообщение (кодировка по умолчанию)
  );

Тип указателя на эту функцию

RDS_VS (для UTF8) или RDS_VWs (для UTF16)

Параметр

ErrorMsg (RDSCSTR, RDSWCSTR, RDSXCSTR)

Указатель на строку (char* или wchar_t*, в зависимости от версии функции) с сообщением об ошибке.

Примечания

Эта функция может вызываться только из функции модели блока в момент реакции на событие загрузки данных блока в текстовом формате RDS_BFM_LOADTXT, во всех остальных случаях вызов игнорируется.

При загрузке данных блока в текстовом формате обнаруженные в данных ошибки (неизвестные ключевые слова, ошибки формата и т.п.) обычно не показываются пользователю немедленно – при большом количестве ошибок ему пришлось бы постоянно нажимать кнопку «OK» в окне сообщения. Вместо этого из сообщений о возникших ошибках формируется список, который показывается пользователю по окончании загрузки схемы (или блока, если загружался только один блок). Функция rdsReportTextLoadError позволяет добавить в этот список произвольное сообщение, при этом имя блока, из реакции которого вызвана функция, добавится к сообщению автоматически.

См. также

RDS_BFM_LOADTXT.