chsize

Aus Appmethod Topics
Wechseln zu: Navigation, Suche

Nach oben zu io.h - Index


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";
    /* Textdatei mit 10 Bytes erstellen */
    handle = open("DUMMY.FIL", O_CREAT);
    write(handle, buf, strlen(buf));
    /* Datei auf eine Größe von 5 Bytes verkürzen */
    chsize(handle, 5);
    /* Datei schließen */
    close(handle);
    return 0;
 }



Portabilität



POSIX Win32 ANSI C ANSI C++

+