ファイル

名前空間：　file
■ファイルコピー■ファイル移動■テキストファイル読み込み■ファイル書き込み(新規)
■ファイル書き込み(追加)■シンボリックリンク作成■ファイル削除■ファイル情報取得


ファイルコピー
関数名copy(str_dst_filename, str_src_filename)
引数str_dst_filename
　コピー先のファイル名

str_src_filename
　コピー元のファイル名

戻り値正常にコピーできた場合 true
それ以外 false
イベント無し
備考コピー元ファイルの権限および時刻が、コピー先ファイルにも引き継がれます。
呼び出し例file::copy("コピー先.txt", "コピー元.txt");


ファイル移動
関数名move(str_dst_filename, str_src_filename)
引数str_dst_filename
　移動先のファイル名

str_src_filename
　移動元のファイル名

戻り値正常にコピーできた場合 true
それ以外 false
イベント無し
備考移動元ファイルの権限および時刻が、移動先ファイルにも引き継がれます。
呼び出し例file::move("移動先.txt", "移動元.txt");


テキストファイル読み込み
関数名read_text(str_filename)
引数str_filename
　読み込むテキストファイル名

戻り値正常に読み込めた場合 ファイル内容(文字列)
読み込み結果が0行でも正常に読み込めたとみなします
それ以外 null
イベント正常に読み込めた場合、$resultに
一行分の情報がセットされ、イベントが発行されます。
$result['number']　イベントが発行された行(1～)
$result['line']　行内容
呼び出し例file::read_text("読み込む.txt"){ println($result['number'] . ': => ' . $result['line']); }


ファイル書き込み(新規)
関数名write(str_filename, str_write)
引数str_filename
　書き込むテキストファイル名

　str_write
　書き込む内容

戻り値正常に書き込めた場合 true
それ以外 false
イベント無し
呼び出し例file::write("書き込む.txt", "書き込み内容");


ファイル書き込み(追加)
関数名append(str_filename, str_write)
引数str_filename
　書き込むテキストファイル名

str_write
　書き込む内容

戻り値正常に書き込めた場合 true
それ以外 false
イベント無し
呼び出し例file::append("追加書き込む.txt", "書き込み内容");


シンボリックリンク作成
関数名symlink(str_sym_name, str_src_name)
引数 str_sym_name
　シンボリックファイル名

str_src_name
　参照元ファイル(ディレクトリ)名

戻り値正常に作成できた場合 true
それ以外 false
イベント無し
備考現在(Ver 0.76)は、linux 版のみです。
将来的には Vista ではフルに、XP 以前はジャンクションのみの対応にする予定です。
呼び出し例file::symlink("シンボリックファイル名", "参照元ファイル名");


ファイル削除
関数名delete(str_filename)
引数str_filename
　削除するファイル名

戻り値正常に削除できた場合 true
それ以外 false
イベント無し
呼び出し例file::delete("削除する.txt");


ファイル情報取得
関数名stat(str_filename)
引数str_filename
　情報を取得したいファイル名

戻り値正常に取得できた場合、以下の項目をキーとする連想配列を返します。
'dev'　ファイルがあるデバイスの ID
'ino'　inode 番号
'mode'　アクセス権限
'nlink'　ハードリンクの数
'uid'　所有者のユーザ ID
'gid'　所有者のグループ ID
'rdev'　デバイス ID
'size'　全体のサイズ
'atime'　最終アクセス日時
'mtime'　最終更新日時
'ctime'　最終状態変更日時
'read'　読み込みが許可の場合true、それ以外 false
'write'　書き込みが許可の場合true、それ以外 false
'execute'　実行が許可の場合true、それ以外 false
'blksize'　ファイルシステム I/O でのブロックサイズ(linux 版のみ)
'blocks'　割り当てられたブロック数(linux 版のみ)

情報取得に失敗した場合、null
イベント無し
呼び出し例array_info = file::stat("ファイル名");