tempnam()

Установить имя для временного файла

Прототип:

#include <stdio.h>
                                       
char * tempnam( const char *dir,
                const char *pfx );

Аргументы:

dir

NULL или директория, используемая в пути файла.

pfx

NULL или префикс, используемый в пути файла.

---

Если pfx не равен NULL, то строка, на которую он указывает, должна быть не больше 5 байт.

---

Библиотека:

libc

Описание:

Функция tempnam() генерирует путь для использования в качестве временного файла. Путь находится в каталоге, указанном в dir, и имеет префикс, указанный в pfx.

Если dir имеет значение NULL, имя пути имеет префикс первого доступного каталога, содержащегося в:

• каталоге временных файлов P_tmpdir (определен в <stdio.h>)
• переменной среды TMPDIR
• константе _PATH_TMP (определена в <paths.h>).

Если все эти пути недоступны, tempnam() пытается использовать /tmp, а затем текущий рабочий каталог.

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

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

Указатель на созданное имя файла, который необходимо освободить вызовом free(), когда в последнем не будет больше необходимости или NULL в случае ошибки.

Коды ошибок:

ENOMEM

Недостаточно памяти для создания пути.

Классификация:

POSIX 1003.1 X/Open Systems Interfaces Extension

Безопасность использования

Точка остановки потока

Нет

Обработчик прерываний

Нет

Обработчик сигналов

Нет

В потоке

Нет

Предостережения:

Функция tempnam() создаёт только пути; приложение само должно создавать и удалять файлы.

Другой поток или процесс может создать файл с тем же именем в промежутке между созданием пути и открытием файла.

Тематические ссылки:

free(), tmpfile(), tmpnam(), unlink()

Предыдущий раздел: Описание API системной библиотеки