Function FORMAT

UP


Function FORMAT

Function FORMAT

構文

format destination control-string &rest args => result

引数と戻り値

destination - nil, t, ストリーム, あるいはfill-pointerをもつ文字列
control-string - format-control
args - control-stringのformat-arguments
result - destinationnilではないときはnil、 それ以外は文字列

定義

formatは、 control-stringの文字の出力と チルダによって導入される指示の観測によって、 書式化された出力を生成します。 チルダの後の文字はパラメーターのプレフィックスによる 先行された文字である可能性があり、 修正や何らかの書式化の種類を特定したいものを表します。 ほとんどの指示は、それらの出力を生成するために ひとつか複数のargsを使用します。

もしdestinationが文字列かストリームかtのとき、 resultnilです。 それ以外はresultは「出力」を含んだ文字列です。

formatは きれいに書式化されたテキストの生成や、 見栄えがよいメッセージの生成などを出力するのに使いやすいものです。 formatは生成されたものを文字列として返却できますし、 destinationへ出力することもできます。

control-stringがどのように解釈されるかの詳細は、 22.3. 書式出力をご確認ください。

例文

なし。

影響

*standard-output*, *print-escape*, *print-radix*, *print-base*, *print-circle*, *print-pretty*, *print-level*, *print-length*, *print-case*, *print-gensym*, *print-array*

例外

もしdestinationがfill-pointerを持った文字列であり、 その呼び出しの動的エクステント期間中に 破壊的修正がその文字列に直接生じたときの結果は未定義です。

参考

write, 13.1.10. 処理系実装のスクリプトの説明

備考

なし。


TOP, Github