Метод append

Метод append применяется к объекту Index и возвращает новый индекс, который является результатом объединения исходного индекса с другим индексом или последовательностью значений. Первым параметром передается объединяемый объект, вторым можно указать, нужно ли проверять уникальность элементов.

Синтаксис

index.append(other, verify_integrity=False)

Пример

Давайте объединим два числовых индекса:

import pandas as pd

idx1 = pd.Index([1, 2, 3])
idx2 = pd.Index([4, 5, 6])
res = idx1.append(idx2)
print(res)

Результат выполнения кода:

Index([1, 2, 3, 4, 5, 6], dtype='int64')

Пример

Можно добавить индекс к строковому индексу:

import pandas as pd

idx1 = pd.Index(['a', 'b', 'c'])
idx2 = pd.Index(['d', 'e'])
res = idx1.append(idx2)
print(res)

Результат выполнения кода:

Index(['a', 'b', 'c', 'd', 'e'], dtype='object')

Пример

Вторым параметром можно передать список значений:

import pandas as pd

idx = pd.Index([10, 20, 30])
res = idx.append([40, 50])
print(res)

Результат выполнения кода:

Index([10, 20, 30, 40, 50], dtype='int64')

Пример

Если установить параметр verify_integrity в True, то при наличии дублирующихся элементов будет вызвана ошибка:

import pandas as pd

idx1 = pd.Index([1, 2, 3])
idx2 = pd.Index([3, 4, 5])
try:
	res = idx1.append(idx2, verify_integrity=True)
except ValueError as e:
	print(e)

Результат выполнения кода:

"Indexes have overlapping values: [3]"

Смотрите также

метод union,
который возвращает объединение индексов без дубликатов
метод intersection,
который находит пересечение двух индексов
метод difference,
который возвращает разность индексов
метод insert,
который вставляет элемент в индекс по указанной позиции