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

### 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

lindex — リストから要素を取出す Retrieve an element from a list

### 構文 SYNOPSIS

lindex list ?index ...?

### 説明 DESCRIPTION

この lindex 命令は､ Tcl がリストとして扱う假引数 list を受取る｡更に､零若しくはそれ以上の個数の index をリストに入れて受取る｡その index は､命令行に連続して並べるか､又は､Tclのリストの中にまとめて､一つの引数として置くかして好い｡ The lindex command accepts a parameter, list, which it treats as a Tcl list. It also accepts zero or more indices into the list. The indices may be presented either consecutively on the command line, or grouped in a Tcl list and presented as a single argument.

index なしの場合は､この命令はこの様な形式になる: If no indices are presented, the command takes the form:

    lindex list

又は or

    lindex list {}

この場合､ lindex の返り値は単に假引数 list の値である｡ In this case, the return value of lindex is simply the value of the list parameter.

indexが一つだけの場合､ lindex 命令は list を Tcl リストとして扱い､そこから index 番目の要素を返す(0はリストの最初の要素を指す)｡要素の抽出では､ lindex は､Tcl 命令の解釈実行機能としての､波形括弧､引用符号､逆斜線､を考慮した通常の規則を遵守する; しかし､変数置換と命令置換は起らない｡もし index が負値又は､ 値 中の要素の個数以上であると､空文字列が返る｡それぞれの単純な index の値の解釈は命令 string index と同じであり､単純算術指定､リストの末尾に対する相対指定に対応している｡ 　　 When presented with a single index, the lindex command treats list as a Tcl list and returns the index'th element from it (0 refers to the first element of the list). In extracting the element, lindex observes the same rules concerning braces and quotes and backslashes as the Tcl command interpreter; however, variable substitution and command substitution do not occur. If index is negative or greater than or equal to the number of elements in value, then an empty string is returned. The interpretation of each simple index value is the same as for the command string index, supporting simple index arithmetic and indices relative to the end of the list.

追加的な index 引数が与えられると､それぞれの引数は以前の索引操作から要素を順番に選択することに使われ､その記述譜に子供のリストから要素を選択することを許容する｡次の命令は､　　　　 If additional index arguments are supplied, then each argument is used in turn to select an element from the previous indexing operation, allowing the script to select elements from sublists. The command,

    lindex $a 1 2 3

又は or

    lindex $a {1 2 3}

は､次と類義である is synonymous with

    lindex [lindex [lindex $a 1] 2] 3

### 用例 EXAMPLES

リストはどちらの端からも索引可能:　　　　　 Lists can be indexed into from either end:

    lindex {a b c} 0
          → a
    lindex {a b c} 2
          → c
    lindex {a b c} end
          → c
    lindex {a b c} end-1
          → b

索引のリスト又は並びは､リストのリストからの選択を許容する｡ 　　　　 Lists or sequences of indices allow selection into lists of lists:

    lindex {a b c}
          → a b c
    lindex {a b c} {}
          → a b c
    lindex {{a b c} {d e f} {g h i}} 2 1
          → h
    lindex {{a b c} {d e f} {g h i}} {2 1}
          → h
    lindex {{{a b} {c d}} {{e f} {g h}}} 1 1 0
          → g
    lindex {{{a b} {c d}} {{e f} {g h}}} {1 1 0}
          → g

リストの索引は別の索引に固定値を足すか引くかだけの限定された計算を実行してもよい: 　　　 List indices may also perform limited computation, adding or subtracting fixed amounts from other indices:

    set idx 1
    lindex {a b c d e f} $idx+2
          → d
    set idx 3
    lindex {a b c d e f} $idx+2
          → f

### SEE ALSO

list, lappend, lassign, ledit, linsert, llength, lmap, lpop, lrange, lremove, lrepeat, lreplace, lreverse, lsearch, lseq, lset, lsort, string

### KEYWORDS

element, index, list
Copyright © 1993 The Regents of the University of California.
Copyright © 1994-1996 Sun Microsystems, Inc.
Copyright © 2001 Kevin B. Kenny <kennykb(at)acm.org>. All rights reserved.