Метод item
Метод item применяется к Series и возвращает единственное значение
в виде скаляра (числа, строки или логического значения).
Этот метод полезен, когда вы уверены, что серия содержит только один элемент,
и вам нужно получить его значение, а не объект Series.
Если серия содержит более одного элемента или пуста, метод вызывает ошибку.
Метод не принимает никаких параметров.
Синтаксис
ser.item()
Пример
Давайте создадим серию из одного элемента и получим его значение:
import pandas as pd
ser = pd.Series([42])
res = ser.item()
print(res)
Результат выполнения кода:
42
Пример
Метод также работает со строками и логическими значениями:
import pandas as pd
ser_str = pd.Series(['article'])
res_str = ser_str.item()
print(res_str)
ser_bool = pd.Series([True])
res_bool = ser_bool.item()
print(res_bool)
Результат выполнения кода:
article
True
Пример
Если серия содержит несколько элементов, метод item вызывает ошибку.
Давайте посмотрим на это поведение:
import pandas as pd
ser = pd.Series([1, 2, 3])
try:
res = ser.item()
print(res)
except ValueError as e:
print(f"Error: {e}")
Результат выполнения кода:
"Error: can only convert an array of size 1 to a Python scalar"
Пример
Метод item часто используют в связке с другими методами,
которые возвращают серию с одним элементом, например, после фильтрации:
import pandas as pd
ser = pd.Series([10, 20, 30, 40, 50])
# Получаем значение, где элемент равен 30
value = ser[ser == 30].item()
print(value)
Результат выполнения кода:
30
