Приложения

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

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

А.5.20. Работа с временными файлами

А.5.20.2. rdsTMPCreateEmptyFileAnyExt – создать уникальный временный файл (без учета расширения)

Функция rdsTMPCreateEmptyFileAnyExt создает пустой временный файл и возвращает его имя. В параметрах указывается желаемое имя файла с путем. Если по этому пути существует файл с таким же именем и любым расширением, имя корректируется с сохранением пути и расширения.

  RDSSTR RDSCALL rdsTMPCreateEmptyFileAnyExtA( // UTF8
    int SetId,           // Набор временных файлов
    RDSCSTR DesiredName  // Желаемое имя с путем (UTF8)
  );
  RDSWSTR RDSCALL rdsTMPCreateEmptyFileAnyExtW( // UTF16
    int SetId,           // Набор временных файлов
    RDSWCSTR DesiredName // Желаемое имя с путем (UTF16)
  );
  // Функция-псевдоним
  RDSXSTR RDSCALL rdsTMPCreateEmptyFileAnyExt( // Кодировка по умолчанию
    int SetId,           // Набор временных файлов
    RDSXCSTR DesiredName // Желаемое имя с путем (кодировка по умолчанию)
  );

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

RDS_SIS (для UTF8) или RDS_WsIWs (для UTF16)

Параметры

SetId (int): Уникальный целый идентификатор набора временных файлов, к которому будет принадлежать этот файл.
DesiredName (RDSCSTR, RDSWCSTR, RDSXCSTR): Указатель на строку с желаемым именем файла. Имя должно содержать путь к файлу (возможно использование символических обозначений путей).

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

Указатель на строку во внутренней памяти RDS, содержащую полное (с путем) имя созданного временного файла.

Примечания

Эта функция создает пустой (нулевого размера) временный файл в папке, путь к к которой берется из желаемого имени файла DesiredName. Если на диске в данный момент нет файла с именем DesiredName и любым расширением, файл получит это имя. Если же такой файл уже есть, функция подберет для файла уникальное имя с тем же расширением и разместит его в этой же папке.

Пример

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

См. также

rdsTMPCreateFileSet, rdsTMPDeleteFileSet, rdsTMPCreateEmptyFile, rdsTMPRememberFileName.