polars.DataFrame.get_column#

DataFrame.get_column( name: str, *, default: Any | NoDefault = <no_default>, ) → Series | Any[source]#

按名称获取单个列。

Parameters:

name: 要检索的列的字符串名称。
default: 如果列不存在时返回的值；如果没有明确设置且列不存在，则会引发ColumnNotFoundError异常。

Returns:

Series (or arbitrary default value, if specified).

另请参阅

to_series

示例

>>> df = pl.DataFrame({"foo": [1, 2, 3], "bar": [4, 5, 6]})
>>> df.get_column("foo")
shape: (3,)
Series: 'foo' [i64]
[
    1
    2
    3
]

缺失列处理；可以选择为方法提供一个任意的默认值（否则会引发ColumnNotFoundError异常）。

>>> df.get_column("baz", default=pl.Series("baz", ["?", "?", "?"]))
shape: (3,)
Series: 'baz' [str]
[
    "?"
    "?"
    "?"
]
>>> res = df.get_column("baz", default=None)
>>> res is None
True