Skip to content

daft.functions.lower#

lower #

lower(expr: Expression) -> Expression

Convert UTF-8 string to all lowercase.

Returns:

Name Type Description
Expression Expression

a String expression which is self lowercased

Examples:

1
2
3
4
5
>>> import daft
>>> from daft.functions import lower
>>> df = daft.from_pydict({"x": ["FOO", "BAR", "BAZ"]})
>>> df = df.select(lower(df["x"]))
>>> df.show()
╭────────╮
│ x      │
│ ---    │
│ String │
╞════════╡
│ foo    │
├╌╌╌╌╌╌╌╌┤
│ bar    │
├╌╌╌╌╌╌╌╌┤
│ baz    │
╰────────╯
(Showing first 3 of 3 rows)
Source code in daft/functions/str.py
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
def lower(expr: Expression) -> Expression:
    """Convert UTF-8 string to all lowercase.

    Returns:
        Expression: a String expression which is `self` lowercased

    Examples:
        >>> import daft
        >>> from daft.functions import lower
        >>> df = daft.from_pydict({"x": ["FOO", "BAR", "BAZ"]})
        >>> df = df.select(lower(df["x"]))
        >>> df.show()
        ╭────────╮
        │ x      │
        │ ---    │
        │ String │
        ╞════════╡
        │ foo    │
        ├╌╌╌╌╌╌╌╌┤
        │ bar    │
        ├╌╌╌╌╌╌╌╌┤
        │ baz    │
        ╰────────╯
        <BLANKLINE>
        (Showing first 3 of 3 rows)

    """
    return Expression._call_builtin_scalar_fn("lower", expr)