## Tcl8.6.17/Tk8.6.17 Documentation > Tcl Commands > lappend

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

lappend — 変数にリストの要素を追加する Append list elements onto a variable

### 構文 SYNOPSIS

lappend varName ?value value value ...?

### 説明 DESCRIPTION

本命令は varName によって与えられる変数をリストとして扱い､そのリストに､それぞれの value 引数を区切られた要素として､要素間を空白で区切って､追記する｡もし､ varName が実在しないと､ value 引数によって与えられた要素を伴うリストとして生成される｡lappend は value が未加工の文ではなくリストの要素として追加されることを除き､append に似ている｡この命令は比較的効果的に長いリストを構築できる｡譬えば､ “lappend a $b” は $a が長い場合､ “set a [concat $a [list $b]]” よりも遥かに効果的である｡(訳註 要素をリストの先頭に追加する命令は eval 命令の用例の項(lprepend)を参照されたい｡) 　 This command treats the variable given by varName as a list and appends each of the value arguments to that list as a separate element, with spaces between elements. If varName does not exist, it is created as a list with elements given by the value arguments. Lappend is similar to append except that the values are appended as list elements rather than raw text. This command provides a relatively efficient way to build up large lists. For example, “lappend a $b” is much more efficient than “set a [concat $a [list $b]]” when $a is long.

### 用例 EXAMPLE

番号のリスト作成に lappend を使う｡ 　　 Using lappend to build up a list of numbers.

    % set var 1
    1
    % lappend var 2
    1 2
    % lappend var 3 4 5
    1 2 3 4 5

### SEE ALSO

list, lindex, linsert, llength, lset, lsort, lrange

### KEYWORDS

append, element, list, variable
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.