_chsize
ファイル サイズを変更します。 より安全なバージョンが利用可能です。 _chsize_sを参照してください。
構文
int _chsize(
int fd,
long size
);
パラメーター
fd
開いているファイルを参照するファイル記述子。
size
バイト単位のファイルの新しい長さ。
戻り値
ファイル サイズが正常に変更された場合は、_chsize は値 0 を返します。 戻り値 -1 は、エラーを示します。errnoは、指定したファイルが読み取り専用の場合、または指定されたファイルがアクセスに対してロックされている場合、記述子が無効な場合はEBADF、デバイスにスペースが残っていない場合はENOSPC、sizeが 0 未満の場合はEINVALに EACCES設定されます。
リターン コードの詳細については、「errno、_doserrno、_sys_errlist、および _sys_nerr」を参照してください。
解説
_chsize 関数は、fd に関連付けられているファイルを size に指定された長さに拡張するか切り捨てます。 ファイルは、書き込みを許可するモードで開かれている必要があります。 ファイルが拡張される場合は、null 文字 ('\0') が追加されます。 ファイルが切り捨てられる場合、短くなったファイルの末尾からファイルの元の長さまでのすべてのデータは失われます。
この関数は、パラメーターを検証します。 sizeが 0 未満の場合、またはfdが無効なファイル記述子である場合は、「パラメーター検証で説明されているように、無効なパラメーター ハンドラーが呼び出されます。
既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT でのグローバル状態」を参照してください。
要件
| ルーチンによって返される値 | 必須ヘッダー | オプション ヘッダー |
|---|---|---|
_chsize |
<io.h> | <errno.h> |
互換性の詳細については、「 Compatibility」を参照してください。
例
// 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