_chsize
Změní velikost souboru.Bezpečnější verze je k dispozici; see _chsize_s.
int _chsize(
int fd,
long size
);
Parametry
fd
Popisovač souboru ve vztahu k otevření souboru.size
Nová délka souboru v bajtech.
Vrácená hodnota
_chsizeVrátí hodnotu 0, pokud velikost souboru úspěšně změněno.Vrácenou hodnotu –1 označuje chybu: errno je nastavena na EACCES Pokud zadaný soubor je uzamčen proti přístupu, na EBADF -li zadaný soubor je jen pro čtení nebo je neplatný, ENOSPC Pokud již není místo na zařízení, nebo EINVAL Pokud size je menší než nula.
Viz _doserrno, kód chyby, _sys_errlist a _sys_nerr Další informace o těchto a jiných návratových kódů.
Poznámky
_chsize Funkce rozšiřuje nebo zkrátí soubor přidružený k fd na délku uvedenou size.Soubor musí být otevřen v režimu, který umožňuje psaní.Pokud je soubor rozšířen, jsou připojeny znaky Null (\0).Pokud je soubor zkrácen, všechna data z konce zkrácený soubor na původní délku souboru ztracen.
Tato funkce ověřuje jeho parametry.Pokud size je menší než nula nebo fd je chybný soubor deskriptoru, vyvolat neplatný parametr popisovače, jak je popsáno v Ověření parametrů.
Požadavky
Rutina |
Požadované záhlaví |
Volitelné záhlaví |
|---|---|---|
_chsize |
<io.h> |
<errno.h> |
Další informace o kompatibilitě v tématu Compatibility v úvodu.
Příklad
// 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 );
}
}