open

(open filename &optional direction element-type)

ファイルを開いてストリームを返します。省略可能な direction は :input（デフォルト。読み込み用に開く）または :output（作成または切り詰めて書き込み用に開く）です。キーワード引数形式 (open filename :direction :output :if-exists :append) は既存ファイルを切り詰めずに書き込み用に開き、すべての書き込みが末尾に追加されます。:if-exists/:if-does-not-exist/:external-format のそれ以外の値は、ネイティブの挙動と一致するもの（:supersede、:create/:error、:utf-8/:default）だけを受け付けます。省略可能な element type はストリームの種類を選択します。'character（デフォルト）は read/read-line/write-line 用のテキストストリームを、'(unsigned-byte 8)（サイズなしの 'unsigned-byte も同様）は read-byte/write-byte/read-sequence/write-sequence 用のバイナリストリームを開きます。キーワード形式ではオプションの値は計算された値でも構いません（(open path :direction dir :element-type type)）。その値は呼び出しの実行時に読み取られ、対応するリテラル形にディスパッチされます。これにより、移植性のあるラッパーがオプションを引数として受け取れます。リテラルの値は従来どおりコンパイル時に解決され、サポート範囲外の値は呼び出しの実行時にエラーを通知します。返されるストリームは不透明なハンドル（インタプリタ/JVM ではストリームテーブルへのインデックス、WASM では WASI ファイルディスクリプタ）で、その実行内でのみ有効です。対応する読み書き関数に渡したうえで close してください。WASM ではパスはプリオープンされたディレクトリに対して解決されます。相対パスは最初の 1 つ、絶対パスは名前がそのパスの最長の接頭辞になるプリオープンディレクトリに対して解決されます。そのため --dir を付けて実行してください。ストリームを自動的にクローズする with-open-file の利用を推奨します。

(let ((s (open "data.txt")))
  (print (read-line s))
  (close s))

これは data.txt を入力用に開き、最初の行を読み込み、ストリームをクローズします。代わりに :output を渡すと、書き込み用にファイルを作成または切り詰めます。(open "data.bin" :input '(unsigned-byte 8)) は同じ種類のハンドルをバイナリモードで開きます。