= History 組込みコマンド
:encoding: UTF-8
:lang: ja
//:title: Yash マニュアル - History 組込みコマンド

dfn:[History 組込みコマンド]は{zwsp}link:interact.html#history[コマンド履歴]を編集します。

[[syntax]]
== 構文

- +history [-cF] [-d {{項目}}] [-s {{コマンド}}] [-r {{ファイル}}] [-w {{ファイル}}] [{{個数}}]+

[[description]]
== 説明

History コマンドは{zwsp}link:interact.html#history[コマンド履歴]の内容を編集・表示します。

オプションが指定してある場合、history コマンドはそのオプションに従ってコマンド履歴の内容を編集します。複数のオプションがある場合は指定した順に処理します。

オペランドで{{個数}}が与えられている場合、history コマンドはコマンド履歴の内容をその個数だけ標準出力に出力します。出力の形式は link:_fc.html[fc コマンド]に準じます。

オプションもオペランドも与えられていない場合、history コマンドはコマンド履歴の内容を全て標準出力に出力します。

[[options]]
== オプション

+-c+::
+--clear+::
コマンド履歴をすべて削除します。

+-d {{項目}}+::
+--delete={{項目}}+::
指定した{{項目}}をコマンド履歴から削除します。{{項目}}の指定の仕方は link:_fc.html#operands[fc コマンドの{{始点}}・{{終点}}]オペランドと同じです。

+-F+::
+--flush-file+::
履歴ファイルを再構築します。

+-r {{ファイル}}+::
+--read={{ファイル}}+::
指定した{{ファイル}}からコマンドを読み込み履歴に追加します。ファイルの内容は単なるテキストファイルとして解釈され、それぞれの行の内容が一つのコマンドとして追加されます。

+-s {{コマンド}}+::
+--set={{コマンド}}+::
コマンド履歴の最後の項目を削除し、代わりに指定した{{コマンド}}を追加します。

+-w {{ファイル}}+::
+--write={{ファイル}}+::
指定した{{ファイル}}に現在のコマンド履歴の内容を全て書き出します。既にあるファイルの内容は消去します。履歴は単なるテキストとして一行ずつ書き出します。

[[operands]]
== オペランド

{{個数}}::
表示する履歴の個数です。

[[exitstatus]]
== 終了ステータス

エラーがない限り history コマンドの終了ステータスは 0 です。

[[notes]]
== 補足

History コマンドは{zwsp}link:builtin.html#types[任意組込みコマンド]です。
POSIX では history コマンドの動作は規定されていません。
このコマンドは link:posix.html[POSIX 準拠モード]では使えません。

link:lineedit.html[行編集]の動作中は履歴の内容を変更することはできません。

// vim: set filetype=asciidoc expandtab:
