chsize
Nach oben zu io.h
Header-Datei
io.h
Kategorie
Eingabe-/Ausgaberoutinen
Prototyp
int chsize(int handle, long size);
Beschreibung
Ändert die Dateigröße.
chsize ändert die Größe der mit handle verknüpften Datei. Abhängig vom Wert von size, kann die Datei gegenüber ihrer Originalgröße verkürzt oder erweitert werden.
Die Datei muss in einem Modus geöffnet werden, in dem Schreibzugriffe zulässig sind.
Wenn chsize die Datei erweitert, werden Nullzeichen (\0) angehängt. Wird die Datei verkürzt, gehen alle Daten hinter dem neuen Dateiende-Indikator verloren.
Rückgabewert
Bei erfolgreicher Ausführung gibt chmod den Wert 0 zurück. Bei einem Fehler gibt die Funktion 0 zurück, und die globale Variable errno wird auf einen der folgenden Werte gesetzt:
EACCES |
Permission denied (Zugriff verweigert) |
EBADF |
Bad file number (Falsche Dateinummer) |
ENOSPC |
No space left on device (Kein Speicherplatz auf dem Gerät verfügbar) |
Beispiel
#include <string.h>
#include <fcntl.h>
#include <io.h>
int main(void)
{
int handle;
char buf[11] = "0123456789";
/* create text file containing 10 bytes */
handle = open("DUMMY.FIL", O_CREAT);
write(handle, buf, strlen(buf));
/* truncate the file to 5 bytes in size */
chsize(handle, 5);
/* close the file */
close(handle);
return 0;
}
POSIX | Win32 | ANSI C | ANSI C++ |
---|---|---|---|
+ |