# FS_SetFileLength

## 構文

    #include <nitro/fs.h>

    FSResult	FS_SetFileLength(FSFile *file, u32 length);

## 引数

file | ファイルハンドルを保持したFSFile構造体 読み書き両方のアクセス権を持っている必要があります。
length | 設定するファイルサイズ

## 返り値

処理の結果を`FSResult`型で返します。

## 説明

ファイルのサイズを設定します。
サイズが拡張される場合、拡張された領域の値は不定です。
サイズが縮小される場合、領域外となったシーク位置は新しい終端位置まで補正されます。

## 注意

この操作はファイル終端位置を変更したあとシーク位置を元に戻す処理が必要なため、読み書き両方のアクセス権を必要とします。

## 参照

`FS_OpenFileEx FS_GetFileLength`

## 履歴

2008/12/08 読み書き両方のアクセス権が必要な旨を追記
2007/09/18 初版