UP

Function READ-BYTE

Function READ-BYTE

構文

read-byte stream &optional eof-error-p eof-value => byte

引数と戻り値

stream - バイナリ入力ストリーム
eof-error-p - generalized-boolean。デフォルトはtrue。
eof-value - オブジェクト。デフォルトはnil。
byte - 整数か、eof-value。

定義

read-byteは、 streamからひとつのバイトを読み込み返却します。

もしファイルの終わりに到達したとき、 eof-error-pがfalseのときは、 eof-valueが返却されます。

例文

(with-open-file (s "temp-bytes" 
                    :direction :output
                    :element-type 'unsigned-byte)
   (write-byte 101 s)) =>  101
(with-open-file (s "temp-bytes" :element-type 'unsigned-byte)
   (format t "~S ~S" (read-byte s) (read-byte s nil 'eof)))
>>  101 EOF
=>  NIL

副作用

streamを変更します。

影響

なし。

例外

streamがストリームではないときは、 型type-errorのエラーを通知するべきです。

streamがバイナリ入力ストリームではないときは、 型type-errorのエラーを通知するべきです。

もしeof-error-pがtrueであり、 streamに残りのバイトが存在しないときは、 型end-of-fileのエラーが通知されます。

参考

read-char, read-sequence, write-byte

備考

なし。

TOP, Github