Open

構文: (open filename mode)

機能: LISPの入出力関数がアクセスできるようにファイルを開く。

引数

filename : 開くファイルの名前と拡張子を指定する文字列。ファイルの完全パスを指定しなかった場合、スタートアップディレクトリを指定したものとみなされる。
mode : ファイルを読み込みモード、書き出しモード、追加モードのいずれで開くかを指定する。次の文字のいずれか 1 つを含む文字列を指定する。

r : 読み込みモードで開く。
w : 書き出しモードで開く。filename 引数のファイルが存在しない場合、新しいファイルが作成、開かれる。ファイルが存在する場合、既存データが上書きされる。開いたファイルに渡されたデータは、close 関数でそのファイルを閉じるまで、実際には書き出されない。
a : 追加モードで開く。filename 引数のファイルが存在しない場合、新しいファイルが作成、開かれる。ファイルが存在する場合、開いた後ポインタが既存のデータの終わりに移動するので、ファイルに書き出される新しいデータは既存のデータの後ろに追加される。
注：mode 引数は、小文字でなければならない。 (今後のリリースで変更されるかも)

戻り値: ファイルを正常に開くことができた場合、他の入出力関数で使用可能なファイルディスクリプタを返す。; モード "r" が指定され、filename 引数のファイルが存在しない場合、 nil を返す。

注: DOS システムの場合、プログラムやテキストエディタによってはテキストファイルの終端を示す EOF 記号([Ctrl]+[Z]、10 進 ASCII コード 26)が書き出される場合がある。テキストファイルを読み込むときに[Ctrl]+[Z] があると、その後にさらにデータが存在する場合でも DOS はファイルの終端とみなす。他のプログラムが作成したファイルに open 関数の "a" モードを使用してデータを追加する場合、テキストファイルの終わりに [Ctrl]+[Z] が挿入されていないかどうかを確認する。

サンプル: 次のように、既存のファイルを開く。

(setq a (open "c:/program files/<CADインストールディレクトリ>/help/filelist.txt" "r")) 
'''#<file "c:/program files/<CADインストールディレクトリ>/help/filelist.txt">'''

次の例は、存在しないファイルに対して open 関数を実行している。

(setq f (open "c:¥¥my documents¥¥new.tst" "w")) 
 '''#<file "c:¥¥my documents¥¥new.tst">'''
 (setq f (open "nosuch.fil" "r")) 
 '''nil'''
 (setq f (open "logfile" "a")) 
 '''#<file "logfile">'''