# gfs_pio_truncate

## Name

gfs_pio_truncate -- 指定した長さにファイル切り詰める。もしくは拡張する。

## Synopsis

    #include <gfarm/gfarm.h>

```char *gfs_pio_truncate``(GFS_File `gf`, file_offset_t `length`);`

## DESCRIPTION

ファイル `gf` の長さを変更します。

引数 `length` がファイル `gf` よりも短かければ切り詰めます。

引数 `length` がファイル `gf` よりも長ければ拡張します。拡張された部分を読んだ場合はゼロを返します。

ファイルポインタは変更しません。

ファイルは書き込み用にオープンされていなければなりません。 このため、オープン時に `GFS_FILE_MODE_WRITE` フラグを指定する必要があります。

## RETURN VALUES

`NULL`

  正常終了を示します。

`GFARM_ERR_NO_MEMORY`

  メモリ不足のため処理を中止しました。

その他

  上記以外のエラーが生じたことを示します。

## SEE ALSO

gfs_pio_create(3), gfs_pio_open(3)