tempnam()

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

Прототип:

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

Аргументы:

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


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

Библиотека:

libc

Описание:

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

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

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

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

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

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

Коды ошибок:

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

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

POSIX 1003.1 XSI

Точка остановки потока
Нет
Обработчик прерываний
Нет
Обработчик сигналов
Нет
В потоке
Нет

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

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

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

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

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




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