creattemp

Nach oben zu io.h

Header File

io.h

Kategorie

Eingabe-/Ausgaberoutinen

Prototyp

int creattemp(char *path, int attrib);

Beschreibung

Erstellt in dem durch path bezeichneten Verzeichnis eine Datei mit einem eindeutigen Dateinamen.

Mit creattemp erstellte Dateien werden stets in dem durch die globale Variable _fmode angegebenen Übersetzungsmodus (O_TEXT oder O_BINARY) erstellt.

path enthält einen mit einem umgekehrten Schrägstrich (\) endenden Pfadnamen. Der eindeutige Dateinamen wird in dem durch path angegebenen Verzeichnis gewählt. Der neu erstellte Dateiname wird im gegebenen String path gespeichert. Die Länge von path muss so gewählt werden, dass path den resultierenden Dateinamen aufnehmen kann. Die Datei wird bei der Programmbeendigung nicht automatisch gelöscht.

Das Argument attrib von creattemp kann den Wert 0 oder eine ODER-Kombination einer beliebigen Anzahl der folgenden (in dos.h definierten) Konstanten enthalten:

FA_HIDDEN	Verborgene Datei
FA_RDONLY	Nur-Lesen-Attribut
FA_SYSTEM	Systemdatei

Wenn die Datei erstellt werden konnte, wird der Dateizeiger auf den Anfang der Datei gesetzt. Die Datei wird zum Lesen und zum Schreiben geöffnet.

Rückgabewert

Bei erfolgreicher Ausführung gibt creattemp das neue Datei-Handle (eine nicht negative Ganzzahl) zurück, andernfalls -1.

Bei einem Fehler wird die globale Variable errno auf einen der folgenden Werte gesetzt:

EACCES	Permission denied (Zugriff verweigert)
EMFILE	Too many open files (Zu viele Dateien geöffnet)
ENOENT	Path or file name not found (Pfad oder Dateiname nicht gefunden)

Beispiel

#include <string.h>
#include <stdio.h>
#include <io.h>
int main(void)
{
   int handle;
   char pathname[128];
   strcpy(pathname, "\\");
   /* create a unique file in the root directory */
   handle = creattemp(pathname, 0);
   printf("%s was the unique file created.\n", pathname);
   close(handle);
   return 0;
}

POSIX	Win32	ANSI C	ANSI C++
	+