Приложения

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

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

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

А.5.4.6. rdsDynStrCat – сложение двух строк

Функция rdsDynStrCat возвращает динамическую строку, содержащую сумму (последовательную запись) двух переданных ей строк.

  RDSSTR RDSCALL rdsDynStrCatA( // UTF8
    RDSCSTR String1,  // Первое слагаемое-строка (UTF8)
    RDSCSTR String2,  // Второе слагаемое-строка (UTF8)
    BOOL NullEmpty    // Можно ли возвращать NULL
  );
  RDSWSTR RDSCALL rdsDynStrCatW( // UTF16
    RDSWCSTR String1, // Первое слагаемое-строка (UTF16)
    RDSWCSTR String2, // Второе слагаемое-строка (UTF16)
    BOOL NullEmpty    // Можно ли возвращать NULL
  );
  // Функция-псевдоним
  RDSXSTR RDSCALL rdsDynStrCat( // Кодировка по умолчанию
    RDSXCSTR String1, // Первое слагаемое-строка (кодировка по умолчанию)
    RDSXCSTR String2, // Второе слагаемое-строка (кодировка по умолчанию)
    BOOL NullEmpty    // Можно ли возвращать NULL
  );

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

RDS_SSSB (для UTF8) или RDS_WsWsWsB (для UTF16)

Параметры

String1 (RDSCSTR, RDSWCSTR, RDSXCSTR): Указатель на строку, с которой будет начинаться строка-результат. Значение NULL в этом параметре эквивалентно передаче пустой строки.
String2 (RDSCSTR, RDSWCSTR, RDSXCSTR): Указатель на строку, которой будет заканчиваться строка-результат. Значение NULL в этом параметре эквивалентно передаче пустой строки.
NullEmpty (BOOL): TRUE, если вместо пустой строки функция должна возвращать NULL, и FALSE, если она должна будет динамически отвести в памяти пустую строку (то есть массив char из единственного символа с нулевым кодом) и вернуть указатель на нее.

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

Указатель на созданную в динамической памяти строку, содержащую сумму двух переданных строк. Например, если в String1 передать «12», а в String2 – «34», будет создана строка «1234».

Примечания

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

Пример

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

См. также

rdsAddToDynStr, rdsFree.