pandas.arrays.StringArray #

pandas.arrays。StringArray (, copy = False ) [来源] #

字符串数据的扩展数组。

警告

StringArray 被认为是实验性的。 API 的实现和部分可能会在没有警告的情况下发生更改。

参数
类似数组的

数据数组。

警告

目前,这需要一个 object-dtype ndarray,其中元素是 Python 字符串或 nan-likes ( None, np.nan, NA)。将来这可能会在没有警告的情况下发生变化。使用 pandas.array()with可以从任何序列创建StringArray 的dtype="string"稳定方法。

版本 1.5.0 中的更改:除了字符串和参数之外,StringArray 现在还接受包含 nan-likes( None, np.nan) 的数组类型valuespandas.NA

复制bool,默认 False

是否复制数据数组。

也可以看看

pandas.array()

推荐的用于创建 StringArray 的函数。

Series.str

字符串方法可在 StringArray 支持的 Series 上使用。

笔记

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

属性

没有任何

方法

没有任何