Python: リストの末尾に要素を追加する append()の使い方

Pythonでリストの末尾に新たに要素を追加したい場合、 リストオブジェクトのappend()メソッドを使用します。 ここではappend()メソッドの使い方を紹介します。

append()の書式とサンプルコード

書式
リスト.append(値)

引数に追加したい値を1つ指定します。戻り値はNoneです。

append()メソッドを使ってリストに要素を追加しています。 リストの末尾に要素が追加されているのが確認できます。

li  = ["a", "b", "c"]

# 追加
li.append("d") 

print(li) # ['a', 'b', 'c', 'd']

# 追加
li.append("e")

print(li) # ['a', 'b', 'c', 'd', 'e']

append()の戻り値は?

append()メソッドの戻り値は「None」です。 Noneなので戻り値を取得しても特に意味はありません。 ですから通常は戻り値を受け取らずに 「リスト.append(値)」と記述します。

試しに戻り値を取得してみます。

li  = ["a", "b", "c"]

re = li.append("d")

print(re) # None

append()で複数の値を追加できる?

append()で追加できるのは「1つの値」です。 複数の値をまとめて追加することはできません。
次のコードのように引数にカンマ区切りで複数の値「"d", "e"」を追加するとエラーになります。

li  = ["a", "b", "c"]

li.append("d", "e") # エラー

# 実行結果 エラーメッセージ
TypeError: list.append() takes exactly one argument (2 given)

複数の値をまとめて追加したい場合はextend()メソッドを使います。

li  = ["a", "b", "c"]

li.extend(["d", "e"])

print(li)  # ['a', 'b', 'c', 'd', 'e']

リストの途中に追加したい場合

append()で追加できるのはあくまで「末尾」だけです。 リストの途中に挿入することはできません。 途中に挿入したい場合は insert()メソッドを使います。

li  = ["a", "b", "c"]

li.insert(1, "x")

print(li)  # ['a', 'x', 'b', 'c']

関連記事: リストの途中に要素を挿入する insert()

Python