Приложения

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

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

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

А.5.4.11. rdsItoA – преобразование целого числа в строку

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

  RDSSTR RDSCALL rdsItoAA( // UTF8
    int Val,      // Целое число
    int Radix,    // Система счисления
    int MinDigits // Минимальное число разрядов
  );
  RDSWSTR RDSCALL rdsItoAW( // UTF16
    int Val,      // Целое число
    int Radix,    // Система счисления
    int MinDigits // Минимальное число разрядов
  );
  // Функция-псевдоним
  RDSXSTR RDSCALL rdsItoA( // Кодировка по умолчанию
    int Val,      // Целое число
    int Radix,    // Система счисления
    int MinDigits // Минимальное число разрядов
  );

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

RDS_SIII (для UTF8) или RDS_WsIII (для UTF16)

Параметры

Val (int)

Преобразуемое значение.

Radix (int)

Система счисления, в которой нужно представить число. Этот параметр может принимать следующие значения:

2	Число будет представлено в двоичной системе счисления с префиксом «0b» (число 3 будет преобразовано в строку «0b11»).
8	Число будет представлено в восьмеричной системе счисления с префиксом «0o» (число 9 будет преобразовано в строку «0o11»).
10	Число будет представлено в десятичной системе счисления без какого-либо префикса (число 123 будет преобразовано в строку «123»).
16	Число будет представлено в шестнадцатеричной системе счисления с префиксом «0x» (число 31 будет преобразовано в строку «0x1f»).

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

MinDigits (int)

Минимально допустимое число разрядов в символьном представлении числа. Если после преобразования в указанной системе счисления в числе окажется меньше MinDigits разрядов, оно будет дополнено нулями слева. Если в числе окажется больше MinDigits разрядов, этот параметр игнорируется.

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

Указатель на созданную в динамической памяти строку с символьным представлением переданного числа. В случае ошибки преобразования возвращается NULL.

Примечания

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

Пример

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

См. также

rdsAtoI, rdsFree.