- 2.17.0 (latest)
- 2.16.0
- 2.15.0
- 2.14.0
- 2.13.0
- 2.12.0
- 2.11.0
- 2.10.0
- 2.9.0
- 2.8.0
- 2.7.0
- 2.6.0
- 2.5.0
- 2.4.0
- 2.3.0
- 2.2.0
- 2.0.0-dev0
- 1.36.0
- 1.35.0
- 1.34.0
- 1.33.0
- 1.32.0
- 1.31.0
- 1.30.0
- 1.29.0
- 1.28.0
- 1.27.0
- 1.26.0
- 1.25.0
- 1.24.0
- 1.22.0
- 1.21.0
- 1.20.0
- 1.19.0
- 1.18.0
- 1.17.0
- 1.16.0
- 1.15.0
- 1.14.0
- 1.13.0
- 1.12.0
- 1.11.1
- 1.10.0
- 1.9.0
- 1.8.0
- 1.7.0
- 1.6.0
- 1.5.0
- 1.4.0
- 1.3.0
- 1.2.0
- 1.1.0
- 1.0.0
- 0.26.0
- 0.25.0
- 0.24.0
- 0.23.0
- 0.22.0
- 0.21.0
- 0.20.1
- 0.19.2
- 0.18.0
- 0.17.0
- 0.16.0
- 0.15.0
- 0.14.1
- 0.13.0
- 0.12.0
- 0.11.0
- 0.10.0
- 0.9.0
- 0.8.0
- 0.7.0
- 0.6.0
- 0.5.0
- 0.4.0
- 0.3.0
- 0.2.0
StringDtype
(
storage
:
typing
.
Optional
[
str
]
=
None
,
na_value
:
pandas
.
_libs
.
missing
.
NAType
|
float
=
< NA
> )
Extension dtype for string data.
Parameters
storage
{"python", "pyarrow"}, optional
If not given, the value of pd.options.mode.string_storage
.
na_value
{np.nan, pd.NA}, default pd.NA .. attribute:: None :noindex: .. method:: None :noindex: .. rubric:: Examples >>> pd.StringDtype() string[python] >>> pd.StringDtype(storage="pyarrow") string[pyarrow]
Whether the dtype follows NaN or NA missing value semantics.
Properties
na_value
Default NA value to use for this type.
This is used in e.g. ExtensionArray.take. This should be the user-facing "boxed" version of the NA value, not the physical NA value for storage. e.g. for JSONArray, this is an empty dictionary.
name
A string identifying the data type.
Will be used for display in, e.g. Series.dtype
type
The scalar type for the array, e.g. int
It's expected ExtensionArray[item]
returns an instance
of ExtensionDtype.type
for scalar item
, assuming
that value is valid (not NA). NA values do not need to be
instances of type
.
Methods
__from_arrow__
__from_arrow__
(
array
:
pyarrow
.
Array
|
pyarrow
.
ChunkedArray
)
-
> BaseStringArray
Construct StringArray from pyarrow Array/ChunkedArray.
construct_array_type
construct_array_type
()
-
> type_t
[
BaseStringArray
]
Return the array type associated with this dtype.
construct_from_string
construct_from_string
(
string
)
-
> Self
Construct a StringDtype from a string.
string
str
The type of the name. The storage type will be taking from string
. Valid options and their storage types are ========================== ============================================== string result storage ========================== ============================================== 'string'
pd.options.mode.string_storage, default python 'string[python]'
python 'string[pyarrow]'
pyarrow ========================== ==============================================
TypeError
