pyarrow.MapScalar#

class pyarrow.MapScalar#

Bases: ListScalar, Mapping

Concrete class for map scalars.

__init__(*args, **kwargs)#

Methods

__init__(*args,**kwargs)
as_py(self,*[,maps_as_pydicts])	Return this value as a Python list or dict, depending on 'maps_as_pydicts'.
cast(self[,target_type,safe,options,...])	Cast scalar value to another data type.
count(value)
equals(self,Scalarother)
get(k[,d])
index(value,[start,[stop]])	Raises ValueError if the value is not present.
items()
keys(self)	Return the keys of the map as a list.
validate(self,*[,full])	Perform validation checks.

Attributes

is_valid	Holds a valid (non-null) value.
type	Data type of the Scalar object.
values

as_py(self, *, maps_as_pydicts=None)#

Return this value as a Python list or dict, depending on maps_as_pydicts.

Parameters:

maps_as_pydictsstr, 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.

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:

target_typeDataType, default None

Type to cast scalar to.

safebool, default True

Whether to check for conversion errors such as overflow.

optionsCastOptions, default None

Additional checks pass by CastOptions

memory_poolMemoryPool, optional

memory pool to use for allocations during function execution.

Returns:

scalarA Scalar of the given target data type.

count(value) → integer -- return number of occurrences of value#

equals(self, Scalar other)#

Parameters:

otherpyarrow.Scalar

Returns:

bool

get(k[, d]) → D[k] if k in D, else d.  d defaults to None.#

index(value[, start[, stop]]) → integer -- return first index of value.#

Raises ValueError if the value is not present.

Supporting start and stop arguments is optional, but recommended.

is_valid#

Holds a valid (non-null) value.

items() → a set-like object providing a view on D's items#

keys(self)#

Return the keys of the map as a list.

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)).

Parameters:

fullbool, default False

If True, run expensive checks, otherwise cheap checks only.

Raises:

ArrowInvalid

values#