Приложения

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

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

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

А.5.10.12. rdsWriteWordValueText – запись целого числа в текстовом формате

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

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

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

RDS_VSI (для UTF8) или RDS_VWsI (для UTF16)

Параметры

Keyword (RDSCSTR, RDSWCSTR, RDSXCSTR)

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

Value (int)

Число, значение которого записывается (всегда используется десятичная система счисления).

Примечания

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

Пример

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

  rdsWriteWordValueTextA("count",34);

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

  count 34

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

См. также

RDS_BFM_SAVETXT, RDS_BFM_LOADTXT, rdsItoA, rdsAtoI.