Get the number of bytes in strings

Description

Get length of the strings as UInt32 (as number of bytes). Use $str$len_chars() to get the number of characters.

Usage

<Expr>$str$len_bytes()

Details

If you know that you are working with ASCII text, lengths will be equivalent, and faster (returns length in terms of the number of bytes).

Value

A polars expression

Examples

library("polars")

pl$DataFrame(
  s = c("Café", NA, "345", "æøå")
)$select(
  pl$col("s"),
  pl$col("s")$str$len_bytes()$alias("lengths"),
  pl$col("s")$str$len_chars()$alias("n_chars")
)

#> shape: (4, 3)
#> ┌──────┬─────────┬─────────┐
#> │ s    ┆ lengths ┆ n_chars │
#> │ ---  ┆ ---     ┆ ---     │
#> │ str  ┆ u32     ┆ u32     │
#> ╞══════╪═════════╪═════════╡
#> │ Café ┆ 5       ┆ 4       │
#> │ null ┆ null    ┆ null    │
#> │ 345  ┆ 3       ┆ 3       │
#> │ æøå  ┆ 6       ┆ 3       │
#> └──────┴─────────┴─────────┘