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

Описания RDS

Приложения

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

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

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

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

# Приложения

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