_chsize

[アーティクル]
08/09/2011

ファイルのサイズを変更します。セキュリティが強化されたバージョンを使用できるようになりました。「_chsize_s」を参照してください。

int _chsize( 
   int fd,
   long size 
);

パラメーター

fd
開いているファイルを参照するファイル記述子。
size
ファイルの新しい長さ (バイト単位)。

戻り値

ファイルサイズが正常に変更された場合、_chsize は 0 という値を返します。戻り値が-1 のエラーを示します。errno設定されているEACCES指定されたファイルへのアクセスに対してにロックされている場合EBADF指定されたファイル読み取り専用か、記述子が無効である場合ENOSPCデバイスは、スペースを残していない場合またはEINVAL場合sizeが 0 未満。

戻り値の詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。

解説

_chsize 関数は、fd に関連付けられたファイルの拡張または切り捨てを実行し、size で指定された長さにファイルサイズを変更します。ファイルは書き込み許可モードで開く必要があります。ファイルが拡張された場合は、Null 文字 ('\0') が追加されます。ファイルが切り捨てられた場合は、切り捨て後のファイルの終端から元のファイル長までに含まれていたデータがすべて失われます。

この関数は、パラメーターを検証します。 size が 0 より小さい場合または fd が無効なファイル記述子の場合は、「パラメーターの検証」に説明されているように、無効なパラメーターハンドラーが呼び出されます。

必要条件

ルーチン	必須ヘッダー	オプションヘッダー
_chsize	<io.h>	<errno.h>

互換性の詳細については、「C ランタイムライブラリ」の「互換性」を参照してください。

使用例

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