Приложения

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

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

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

А.5.4.7. rdsDynStrCopy – создание динамической копии строки

Функция rdsDynStrCopy возвращает динамическую строку, являющуюся копией переданной строки.

  RDSSTR RDSCALL rdsDynStrCopyA( // UTF8
    RDSCSTR String  // Копируемая строка (UTF8)
  );
  RDSWSTR RDSCALL rdsDynStrCopyW( // UTF16
    RDSWCSTR String // Копируемая строка (UTF16)
  );
  // Функция-псевдоним
  RDSXSTR RDSCALL rdsDynStrCopy( // Кодировка по умолчанию
    RDSXCSTR String // Копируемая строка (кодировка по умолчанию)
  );

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

RDS_SS (для UTF8) или RDS_WsWs (для UTF16)

Параметр

String (RDSCSTR, RDSWCSTR, RDSXCSTR)

Указатель на строку, для которой создается динамическая копия.

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

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

Примечания

Эта функция используется в тех случаях, когда для работы модели блока требуется динамическая строка, совместимая с функцией rdsFree – например, если требуется изменить строковую статическую переменную блока (при этом обязательно использовать версию функции для кодировки UTF8, то есть rdsDynStrCopyA).

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

Пример

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

См. также

rdsFree.