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

Описания RDS

Приложения

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

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

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

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

# Приложения

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