Partilhar via


_chsize

Altera o tamanho de um arquivo.Uma versão mais segura está disponível. see _chsize_s.

int _chsize( 
   int fd,
   long size 
);

Parâmetros

  • fd
    Descritor de arquivo se referindo a um arquivo aberto.

  • size
    Novo tamanho do arquivo em bytes.

Valor de retorno

_chsizeRetorna o valor 0 se o tamanho do arquivo for alterado com êxito.Um valor de retorno de – 1 indica um erro: errno for definido como EACCES se o arquivo especificado estiver protegido contra acesso, para EBADF se o arquivo especificado é somente leitura ou o descritor é inválido, ENOSPC se ficar sem espaço no dispositivo, ou EINVAL se size é menor que zero.

Consulte _doserrno, errno, _sys_errlist e _sys_nerr para obter mais informações sobre estes e outros, códigos de retorno.

Comentários

O _chsize função amplia ou trunca o arquivo associado fd para o comprimento especificado pela size.O arquivo deve estar aberto em um modo que permita a gravação.Caracteres nulos ('\0') são acrescentados se o arquivo é estendido.Se o arquivo é truncado, todos os dados do final do arquivo abreviado para o tamanho original do arquivo serão perdidos.

Esta função valida seus parâmetros.Se size é menor que zero ou fd é um descritor de arquivo inválido, o manipulador de parâmetro inválido é invocado, conforme descrito em Validação de parâmetro.

Requisitos

Rotina

Cabeçalho necessário

Cabeçalho opcional

_chsize

<io.h>

<errno.h>

Para obter mais informações de compatibilidade, consulte compatibilidade na introdução.

Exemplo

// 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 );
   }
}
  

Equivalência do .NET Framework

Consulte também

Referência

Manipulação de arquivos

Close

_sopen, _wsopen

Open, _wopen