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 初版