Приложения

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

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

А.5.4. Отведение памяти и преобразование строк

А.5.4.5. rdsDtoA – преобразование вещественного числа в строку

Функция rdsDtoA преобразует вещественное число двойной точности в динамическую строку с его символьным представлением.

  RDSSTR RDSCALL rdsDtoAA( // UTF8
    double Val,  // Вещественное число
    int Dec,     // Число знаков дробной части
    int *pLength // Возвращаемая длина строки
  );
  RDSWSTR RDSCALL rdsDtoAW( // UTF16
    double Val,  // Вещественное число
    int Dec,     // Число знаков дробной части
    int *pLength // Возвращаемая длина строки
  );
  // Функция-псевдоним
  RDSXSTR RDSCALL rdsDtoA( // Кодировка по умолчанию
    double Val,  // Вещественное число
    int Dec,     // Число знаков дробной части
    int *pLength // Возвращаемая длина строки
  );

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

RDS_SDIpI (для UTF8) или RDS_WsDIpI (для UTF16)

Параметры

Val (double)

Вещественное число, преобразуемое в строку.

Dec (int)

Число десятичных знаков в дробной части числа. Можно вместо числа знаков передать значение −1, тогда число знаков дробной части будет автоматически подобрано так, чтобы отбросить все незначащие нули справа.

pLength (int*)

Указатель на целую переменную, в которую функция должна записать длину получившейся строки. Если вызывающей программе не нужна длина строки, в этом параметре можно передать NULL.

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

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

Примечания

Динамическая строка, созданная функцией rdsDtoA, должна быть обязательно освобождена функцией rdsFree.

Пример

Пример использования функции rdsDtoA приведен в §2.11 руководства программиста.

См. также

rdsAtoD, rdsGetHugeDouble, rdsFree.