Приложения

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

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

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

А.5.10.10. rdsWriteWordDoubleText – запись вещественного числа в текстовом формате

Функция rdsWriteWordDoubleText добавляет к данным, сохраняемым блоком в текстовом формате, значение указанного в параметрах вещественного числа с предваряющим его, если это необходимо, ключевым словом.

  void RDSCALL rdsWriteWordDoubleTextA(
    RDSCSTR Keyword,  // Ключевое слово (UTF8)
    double Value      // Число
  );
  void RDSCALL rdsWriteWordDoubleTextW(
    RDSWCSTR Keyword, // Ключевое слово (UTF16)
    double Value      // Число
  );
  // Функция-псевдоним
  void RDSCALL rdsWriteWordDoubleText(
    RDSXCSTR Keyword, // Ключевое слово (кодировка по умолчанию)
    double Value      // Число
  );

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

RDS_VSD (для UTF8) или RDS_VWsD (для UTF16)

Параметры

Keyword (RDSCSTR, RDSWCSTR, RDSXCSTR)

Указатель на строку (char* или wchar_t*, в зависимости от версии функции) с ключевым словом, или NULL, если ключевое слово добавлять не нужно.

Value (double)

Число, значение которого записывается (при записи отбрасываются незначащие нули).

Примечания

Эта функция может вызываться только из функции модели блока в момент реакции на события записи данных блока в текстовом формате RDS_BFM_SAVETXT, во всех остальных случаях вызов игнорируется. Она добавляет преобразованное в текст вещественное число (с ключевым словом или без него) к общему набору текстовых данных блока. После завершения реакции на событие RDS_BFM_SAVETXT это набор будет записан в файл или буфер обмена (в зависимости от того, для чего сохраняются данные блока). Перед текстом всегда добавляется пробел.

Если в параметре Value передано специальное значение-индикатор ошибки (см. функцию rdsGetHugeDouble), вместо значения числа будет записан вопросительный знак.

Пример

Вызов функции

  rdsWriteWordDoubleTextA("scale",100.10);

добавит к текстовым данным блока пробел и следующий текст:

  scale 100.1

Другой пример использования функции rdsWriteWordDoubleText приведен в §2.8.4 руководства программиста.

См. также

RDS_BFM_SAVETXT, RDS_BFM_LOADTXT, rdsDtoA, rdsAtoD, rdsGetHugeDouble.