pandas.arrays.StringArray

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

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

Добавлена в версии 1.0.0.

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

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

Параметры

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

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

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

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

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

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

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

См. также

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")
<PandasArray>
['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

Атрибуты

Нет

Методы

Нет