with-open-file

(with-open-file (stream filename options...) body...)

filename で指定されたファイルを開き、開いたストリームを stream に束縛し、その束縛のもとで本体のフォームを評価して、あとでファイルを閉じ、最後の本体フォームの値を返します。インタープリタと JVM では展開が本体を unwind-protect で包むため、あらゆる脱出時（通常復帰、本体内でのエラー通知、return/return-from）にファイルが閉じられます。unwind-protect がコンパイルできない WASM バックエンドでは正常終了時のみ閉じられます。サポートされるオプションは :direction（リテラルのキーワード :input（デフォルト）または :output）と :element-type（リテラルの 'character（デフォルト。テキストストリーム）または '(unsigned-byte 8)（read-byte/write-byte 用のバイナリストリーム））です。コンパイラがファイルモードを静的に決定できるよう、どちらもリテラルでなければなりません。単純な open／close のペアに展開されるため、特別なストリーム型は関与しません。

ファイルシステムに触れるため、with-open-file はここでは実行可能な例ではなく静的に示します。

(with-open-file (s "out.txt" :direction :output)
  (write-line "hello" s))
(with-open-file (s "out.txt" :direction :input)
  (read-line s)) ; => "hello"
(with-open-file (s "out.bin" :direction :output :element-type '(unsigned-byte 8))
  (write-byte 255 s)) ; => 255