pandas.arrays.StringArray

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

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

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

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

Параметры:

values:array-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

copy:bool, default False

Следует ли копировать массив данных.

Атрибуты

None

Методы

None

См. также

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