pyarrow.ExtensionScalar#
- class pyarrow.ExtensionScalar#
Bases:
Scalar
Concrete class for Extension scalars.
- __init__(*args, **kwargs)#
Methods
__init__
(*args, **kwargs)as_py
(self, *[, maps_as_pydicts])Return this scalar as a Python object.
cast
(self[, target_type, safe, options, ...])Cast scalar value to another data type.
equals
(self, Scalar other)- Parameters:
from_storage
(BaseExtensionType typ, value)Construct ExtensionScalar from type and storage value.
validate
(self, *[, full])Perform validation checks.
Attributes
Holds a valid (non-null) value.
Data type of the Scalar object.
Return storage value as a scalar.
- as_py(self, *, maps_as_pydicts=None)#
Return this scalar as a Python object.
- Parameters:
- maps_as_pydicts
str
, optional, default None Valid values are None, ‘lossy’, or ‘strict’. The default behavior (None), is to convert Arrow Map arrays to Python association lists (list-of-tuples) in the same order as the Arrow Map, as in [(key1, value1), (key2, value2), …].
If ‘lossy’ or ‘strict’, convert Arrow Map arrays to native Python dicts.
If ‘lossy’, whenever duplicate keys are detected, a warning will be printed. The last seen value of a duplicate key will be in the Python dictionary. If ‘strict’, this instead results in an exception being raised when detected.
- maps_as_pydicts
- cast(self, target_type=None, safe=None, options=None, memory_pool=None)#
Cast scalar value to another data type.
See
pyarrow.compute.cast()
for usage.- Parameters:
- Returns:
- scalar
A
Scalar
ofthe
given
target
data
type.
- scalar
- equals(self, Scalar other)#
- Parameters:
- other
pyarrow.Scalar
- other
- Returns:
- static from_storage(BaseExtensionType typ, value)#
Construct ExtensionScalar from type and storage value.
- Parameters:
- typ
DataType
The extension type for the result scalar.
- valueobject
The storage value for the result scalar.
- typ
- Returns:
- ext_scalar
ExtensionScalar
- ext_scalar
- is_valid#
Holds a valid (non-null) value.
- type#
Data type of the Scalar object.
- validate(self, *, full=False)#
Perform validation checks. An exception is raised if validation fails.
By default only cheap validation checks are run. Pass full=True for thorough validation checks (potentially O(n)).
- value#
Return storage value as a scalar.