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