pandas.arrays.StringArray

classpandas.arrays.StringArray(values, copy=False)[source]

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

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

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

Параметры:

values:подобный массиву

Массив данных.

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

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

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

copy:bool, по умолчанию False

Копировать ли массив данных.

См. также

pandas.array()

Рекомендуемая функция для создания StringArray.

Series.str

Методы строк доступны для Series, поддерживаемых StringArray.

Примечания

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

Примеры

>>> pd.array(['This is', 'some text', None, 'data.'], dtype="string")
<StringArray>
['This is', 'some text', <NA>, 'data.']
Length: 4, dtype: string

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

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

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

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

>>> pd.array(["a", None, "c"], dtype="string") == "a"
<BooleanArray>
[True, <NA>, False]
Length: 3, dtype: boolean

Атрибуты

None

Методы

None