Method: Polars::StringExpr#decode

Defined in:

lib/polars/string_expr.rb

#decode(encoding, strict: true) ⇒ Expr

Decode a value using the provided encoding.

Examples:

df = Polars::DataFrame.new({"encoded" => ["666f6f", "626172", nil]})
df.select(Polars.col("encoded").str.decode("hex"))
# =>
# shape: (3, 1)
# ┌─────────┐
# │ encoded │
# │ ---     │
# │ binary  │
# ╞═════════╡
# │ b"foo"  │
# │ b"bar"  │
# │ null    │
# └─────────┘

Parameters:

• encoding ("hex", "base64") —

  The encoding to use.

• strict (Boolean) (defaults to: true) —

  How to handle invalid inputs:

  • true: An error will be thrown if unable to decode a value.
  • false: Unhandled values will be replaced with nil.

Returns:

• (Expr)

# File 'lib/polars/string_expr.rb', line 873

def decode(encoding, strict: true)
  if encoding == "hex"
    Utils.wrap_expr(_rbexpr.str_hex_decode(strict))
  elsif encoding == "base64"
    Utils.wrap_expr(_rbexpr.str_base64_decode(strict))
  else
    raise ArgumentError, "encoding must be one of {{'hex', 'base64'}}, got #{encoding}"
  end
end