maxframe.dataframe.Series.dict.get#

Series.dict.get(query_key, default_value=None)#

获取 Series 中每个字典对应键的值。

参数:

  • query_key (Any) -- 要查找的键，必须与字典中的键类型相同。

  • default_value (Any, optional) -- 如果键不在字典中时返回的值，默认为 None。

返回:

一个具有字典值数据类型的 Series。如果键不在字典中，则值为 default_value，如果字典为 None，则值为 None。

返回类型:

Series

参见

Series.dict.__getitem__

获取 Series 中每个字典对应键的值。

示例

创建一个包含字典类型数据的 Series。

>>> import maxframe.dataframe as md
>>> import pyarrow as pa
>>> from maxframe.lib.dtypes_extension import dict_
>>> s = md.Series(
...     data=[[("k1", 1), ("k2", 2)], [("k1", 3)], None],
...     index=[1, 2, 3],
...     dtype=dict_(pa.string(), pa.int64()),
... )
>>> s.execute()
1    [('k1', 1), ('k2', 2)]
2               [('k1', 3)]
3                      <NA>
dtype: map<string, int64>[pyarrow]

>>> s.dict.get("k2", 9).execute()
1       2
2       9
3    <NA>
Name: k2, dtype: int64[pyarrow]