## Tcl9.0.3/Tk9.0.3 Documentation > Tcl Commands > history

### Tcl/Tk Applications | Tcl Commands | Tk Commands | [incr Tcl] Package Commands | SQLite3 Package Commands | TDBC Package Commands | tdbc::mysql Package Commands | tdbc::odbc Package Commands | tdbc::postgres Package Commands | tdbc::sqlite3 Package Commands | Thread Package Commands | Tcl C API | Tk C API | [incr Tcl] Package C API | TDBC Package C API

  NAME
    history — 履歴リストの操作 Manipulate the history list
  構文 SYNOPSIS
  説明 DESCRIPTION
    history
    history add command ?exec?
    history change newValue ?event?
    history clear
    history event ?event?
    history info ?count?
    history keep ?count?
    history nextid
    history redo ?event?
  履歴の改定 HISTORY REVISION
  KEYWORDS

### NAME

history — 履歴リストの操作 Manipulate the history list

### 構文 SYNOPSIS

history ?option? ?arg arg ...?

### 説明 DESCRIPTION

この history 命令は､履歴リストに記録された中の､最近実行された命令に関する幾つかの操作を実施する｡これらの記録された､それぞれの命令は､ “event (行事)” として参照される｡ history 命令への行事を指定する時､次の形式が使用される: The history command performs one of several operations related to recently-executed commands recorded in a history list. Each of these recorded commands is referred to as an “event”. When specifying an event to the history command, the following forms may be used:

1. 数値: もし､正なら､その数値に対応する行事(全ての行事は､１から始まる数値が付けられる)を参照する｡ もし､数値が負なら､現在の行事からの相対的行事を撰ぶ(-1 は前の行事､-2 はその前の行事､以下続く)｡ 行事 0 は現在の行事を参照する｡ A number: if positive, it refers to the event with that number (all events are numbered starting at 1). If the number is negative, it selects an event relative to the current event (-1 refers to the previous event, -2 to the one before that, and so on). Event 0 refers to the current event.

2. 文字列: その文字列に合致する最も最近の行事を選択する｡文字列が行事の最初の文字と一致するか､文字列が行事と､string match 命令の意味で一致するかのどちらかでも､行事がその文字列に一致として扱われる｡ A string: selects the most recent event that matches the string. An event is considered to match the string either if the string is the same as the first characters of the event, or if the string matches the event in the sense of the string match command.

この history 命令は次の形式の孰れでもとり得る: The history command can take any of the following forms:

history
  下に述べる history info と同じ｡ Same as history info, described below.

history add command ?exec?
  この command 引数を履歴リストに行事として追加する｡もし exec (又は略号が)が指定されていると､命令が実行され､その結果が返る｡もし exec が指定されないと､結果として空文字列が返る｡ Adds the command argument to the history list as a new event. If exec is specified (or abbreviated) then the command is also executed and its result is returned. If exec is not specified then an empty string is returned as result.

history change newValue ?event?
  行事について､記録している値を newValue で置換える｡ event は置換える対象の行事を指定する､又無為設定は現在の行事である(-1の行事ではない)｡この命令は､新しい形式の履歴置換の実現と､現在の行事(それが置換を起動)を置換によって創作された命令で置換したいと要望している､命令中での使用を意図している｡返り値は空文字列である｡ Replaces the value recorded for an event with newValue. Event specifies the event to replace, and defaults to the current event (not event -1). This command is intended for use in commands that implement new forms of history substitution and wish to replace the current event (which invokes the substitution) with the command created through substitution. The return value is an empty string.

history clear
  履歴リストを消去する｡現在の保有限度は維持される｡行事履歴番号は解消される｡(訳註 history keep 命令参照) Erase the history list. The current keep limit is retained. The history event numbers are reset.

history event ?event?
  event によって与えられた行事の値を返す｡ event の無為設定は -1 である｡ Returns the value of the event given by event. Event defaults to -1.

history info ?count?
  与えられた行事番号の書式化された文字列と､履歴リスト中の､現在の行事以外の､それぞれの行事を含んでいる番号を返す｡もし､ count が指定されていると､最も最近の count 番号の行事のみが返される｡ Returns a formatted string (intended for humans to read) giving the event number and contents for each of the events in the history list except the current event. If count is specified then only the most recent count events are returned.

history keep ?count?
  この命令は､履歴リストの寸法を count 個の行事が保持される様に変更する｡初期設定では､２０個の行事が履歴リストに保持される｡もし count が指定されないと､現在の保有限度が返る｡ This command may be used to change the size of the history list to count events. Initially, 20 events are retained in the history list. If count is not specified, the current keep limit is returned.

history nextid
  履歴リストに登録される次の番号を返す｡命令行入力促進記号の行事番号印刷などに便利である｡ Returns the number of the next event to be recorded in the history list. It is useful for things like printing the event number in command-line prompts.

history redo ?event?
  event で指定された命令を再実行しその結果を返す｡ event の無為設定は -1｡この命令は履歴の改定を招く: 詳細は下記参照のこと｡ Re-executes the command indicated by event and returns its result. Event defaults to -1. This command results in history revision: see below for details.

### 履歴の改定 HISTORY REVISION

8.0版以前のTclは複雑な履歴改訂の仕組みを有していた｡現在の仕組みは､もう少し限定されていて､又､古い履歴の操作の substitute (置換)と words (単語)は削除された｡(埋合わせに､ clear 操作が追加された｡) Pre-8.0 Tcl had a complex history revision mechanism. The current mechanism is more limited, and the old history operations substitute and words have been removed. (As a consolation, the clear operation was added.)

history 命令の指示項目 redo は “history revision(改訂)” と良く似た結果になる｡この指示項目が起動すると最も最近の行事が修正され､履歴命令が削除され履歴命令の結果で置換えられる｡もし､履歴の修正なく行事の再実行を望むなら､幾つかの行事を取戻すために event 操作を使い､次にそれを履歴に追加する為に add 操作を行い､その後実行されたい｡ The history option redo results in much simpler “history revision”. When this option is invoked then the most recent event is modified to eliminate the history command and replace it with the result of the history command. If you want to redo an event without modifying history, then use the event operation to retrieve some event, and the add operation to add it to history and execute it.

### KEYWORDS

event, history, record
Copyright © 1993 The Regents of the University of California.
Copyright © 1994-1997 Sun Microsystems, Inc.