## Tcl9.0.3/Tk9.0.3 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 引数によって与えられた要素によるリストとして生成される｡無為設定の値を設定させられ実在しない配列の要素を 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. If varName indicate an element that does not exist of an array that has a default value set, list that is comprised of the default value with all the value arguments appended as elements will be stored in the array element. 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, lassign, ledit, lindex, linsert, llength, lmap, lpop, lrange, lremove, lrepeat, lreplace, lreverse, lsearch, lseq, lset, lsort

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