User manual - デバイス制御ライブラリリファレンスマニュアル(2014年10月10日)
106
9.1.11 fil_filesize
ファイルの個数と総サイズ(4GB 以内)を取得します。
ER fil_filesize(
B *
path
,
FIL_SIZE *
buffer
,
UB
find_sw
);
パラメータ
path
検索対象ファイルのパスを、形式 2 で指定します。
buffer
取得結果を格納する、FIL_SIZE構造体のアドレスを指定します。
ファイルの総サイズが 4GB 以上の場合は、
buffer->size
には 4,294,967,295 が返ります。
find_sw
サブディレクトリの検索をする/しないを次の値で指定します。
FIL_SUBDIR_ON
:サブディレクトリ下を検索します
FIL_SUBDIR_OFF
:サブディレクトリ下は検索しません
戻り値
関数が成功すると E_OK が返ります。失敗すると、次のエラーが返ります。
E_NG
:異常終了
E_PRM
:パラメータエラー
解説
path
パラメータの指定形式については、fil_remove関数を参照してください。
path
パラメータには、ワイルドカードを使用することができます。
該当するファイルが存在しない場合、個数 0 個/ファイルサイズ 0 バイトで本関数は正常終了します。
本関数が失敗する要因には次のものがあります。
ファイル/パス名異常(使用不可コード混在)
パス長異常(128 文字以上の指定)
指定ドライブ未フォーマット
指定ドライブ未搭載
ドライブ指定外(C または F 以降)
参照
FIL_SIZE構造
体