Текущий раздел:

Описания RDS

Приложения

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

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

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

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

# Приложения

## Приложение А. Функции, константы и структуры 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.