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++ |
---|---|---|---|
+ |