npt-japanese

% Function GET-OUTPUT-STREAM-STRING

UP


Function GET-OUTPUT-STREAM-STRING

Function GET-OUTPUT-STREAM-STRING

構文

get-output-stream-string string-output-stream => string

引数と戻り値

string-output-stream - ストリーム
string - 文字列

定義

string-output-streamに出力された文字を順番に全て含む文字列を返却します。 この操作はstring-output-stream上の文字をクリアするので、 stringにはget-output-stream-stringが 最後に呼び出された以降のものか、 あるいはstring-output-streamが作成された以降のものから、 最新のものまでに生じた出力のみが含まれます。

例文

(setq a-stream (make-string-output-stream)
       a-string "abcdefghijklm") =>  "abcdefghijklm"
(write-string a-string a-stream) =>  "abcdefghijklm"
(get-output-stream-string a-stream) =>  "abcdefghijklm"
(get-output-stream-string a-stream) =>  ""

副作用

string-output-streamはクリアされます。

影響

なし。

例外

string-output-streamがクローズされていたときの結果は未定義です。

string-output-streammake-string-output-streamによって 生成されたものではないときの結果は未定義です。

string-output-streamwith-output-to-stringformatによって暗黙的に生成されたもののときの結果は未定義です。

参考

make-string-output-stream

備考

なし。


TOP, Github