pandas.arrays.StringArray#

класс pandas.arrays.StringArray(values, copy=False)[источник]#

Расширенный массив для строковых данных.

Предупреждение

StringArray считается экспериментальным. Реализация и части API могут изменяться без предупреждения.

Параметры:

valuesarray-like: Массив данных.

Предупреждение

В настоящее время ожидается ndarray с типом object, где элементы являются строками Python или nan-подобными значениями (None, np.nan, NA). Это может измениться без предупреждения в будущем. Используйте pandas.array() с dtype="string" для стабильного способа создания StringArray из любой последовательности.

Изменено в версии 1.5.0: StringArray теперь принимает массиво-подобные объекты, содержащие nan-подобные значения (None, np.nan) для values параметр в дополнение к строкам и pandas.NA
copybool, по умолчанию False: Следует ли копировать массив данных.

Атрибуты

None

Методы

None

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

pandas.array(): Рекомендуемая функция для создания StringArray.
Series.str: Строковые методы доступны для Series, поддерживаемых StringArray.

Примечания

StringArray возвращает BooleanArray для методов сравнения.

Примеры

>>> pd.array(['This is', 'some text', None, 'data.'], dtype="string")

['This is', 'some text', , 'data.']
Length: 4, dtype: string

В отличие от массивов, созданных с помощью dtype="object", StringArray преобразует значения в строки.

>>> pd.array(['1', 1], dtype="object")

['1', 1]
Length: 2, dtype: object
>>> pd.array(['1', 1], dtype="string")

['1', '1']
Length: 2, dtype: string

Однако прямое создание StringArrays с нестроковыми значениями вызовет ошибку.

Для методов сравнения, StringArray возвращает pandas.BooleanArray:

>>> pd.array(["a", None, "c"], dtype="string") == "a"

[True, , False]
Length: 3, dtype: boolean