_chsize

Ändert die Größe einer Datei. Eine sicherere Version ist verfügbar; siehe _chsize_s.

Syntax

int _chsize(
   int fd,
   long size
);

Parameter

fd
Dateideskriptoren, die auf eine geöffnete Datei verweisen.

size
Neue Länge der Datei in Bytes.

Rückgabewert

_chsize gibt den Wert 0 zurück, wenn die Dateigröße erfolgreich geändert wurde. Ein Rückgabewert von -1 gibt einen Fehler an: wird festgelegt, errno wenn die angegebene Datei schreibgeschützt ist oder die angegebene Datei für den Zugriff gesperrt ist, um zu EBADF überprüfen, ob der Deskriptor ungültig ist, ENOSPC wenn kein Speicherplatz auf dem Gerät verbleibt oder EINVAL kleiner size als Null EACCES ist.

Weitere Informationen zu Rückgabecodes finden Sie unter , , _doserrno, _sys_errlistund _sys_nerr.errno

Hinweise

Die _chsize-Funktion erweitert oder verkürzt die mit fd verknüpfte Datei auf die von size angegebene Länge. Die Datei muss in einem Modus geöffnet sein, der Schreiben zulässt. Wenn die Datei erweitert wird, werden NULL-Zeichen ('\0') angefügt. Wenn die Datei abgeschnitten wird, gehen alle Daten vom Ende der gekürzten Datei bis zur ursprünglichen Länge der Datei verloren.

Diese Funktion überprüft ihre Parameter. Wenn size es sich nicht um null handelt oder fd ein ungültiger Dateideskriptor ist, wird der ungültige Parameterhandler aufgerufen, wie in der Parameterüberprüfung beschrieben.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.

Anforderungen

Routine Erforderlicher Header Optionaler Header
_chsize <io.h> <errno.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Beispiel

// crt_chsize.c
// This program uses _filelength to report the size
// of a file before and after modifying it with _chsize.

#include <io.h>
#include <fcntl.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <stdio.h>
#include <share.h>

int main( void )
{
   int fh, result;
   unsigned int nbytes = BUFSIZ;

   // Open a file
   if( _sopen_s( &fh, "data", _O_RDWR | _O_CREAT, _SH_DENYNO,
                 _S_IREAD | _S_IWRITE ) == 0 )
   {
      printf( "File length before: %ld\n", _filelength( fh ) );
      if( ( result = _chsize( fh, 329678 ) ) == 0 )
         printf( "Size successfully changed\n" );
      else
         printf( "Problem in changing the size\n" );
      printf( "File length after:  %ld\n", _filelength( fh ) );
      _close( fh );
   }
}
File length before: 0
Size successfully changed
File length after:  329678

Siehe auch

Dateibehandlung
_close
_sopen, _wsopen
_open, _wopen