class_docstr: Namespace for string related expressions.
class_docstr_tok: ["Namespace","for","string","related","expressions","."]
docstr: Encode a value using the provided encoding.
  
  Parameters
  ----------
  encoding : {'hex', 'base64'}
      The encoding to use.
  
  Returns
  -------
  Expr
      Expression of data type :class:`String`.
  
  Examples
  --------
  >>> df = pl.DataFrame({"strings": ["foo", "bar", None]})
  >>> df.with_columns(strings_hex=pl.col("strings").str.encode("hex"))
  shape: (3, 2)
  ┌─────────┬─────────────┐
  │ strings ┆ strings_hex │
  │ ---     ┆ ---         │
  │ str     ┆ str         │
  ╞═════════╪═════════════╡
  │ foo     ┆ 666f6f      │
  │ bar     ┆ 626172      │
  │ null    ┆ null        │
  └─────────┴─────────────┘
docstr_tok: ["Encode","a","value","using","the","provided","encoding",".","Parameters","--","--","--","--","--","encoding",":","{","'hex","'",",","'base64","'","}","The","encoding","to","use",".","Returns","--","--","--","-","Expr","Expression","of","data","type",":","class",":","`","String","`",".","Examples","--","--","--","--",">",">",">","df","=","pl.DataFrame","(","{","``","strings","''",":","[","``","foo","''",",","``","bar","''",",","None","]","}",")",">",">",">","df.with_columns","(","strings_hex=pl.col","(","``","strings","''",")",".str.encode","(","``","hex","''",")",")","shape",":","(","3",",","2",")","\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510","\u2502","strings","\u2506","strings_hex","\u2502","\u2502","--","-","\u2506","--","-","\u2502","\u2502","str","\u2506","str","\u2502","\u255e\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u256a\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2561","\u2502","foo","\u2506","666f6f","\u2502","\u2502","bar","\u2506","626172","\u2502","\u2502","null","\u2506","null","\u2502","\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518"]
code: def encode(self, encoding: TransferEncoding) -> Expr:
      """
      Encode a value using the provided encoding.
  
      Parameters
      ----------
      encoding : {'hex', 'base64'}
          The encoding to use.
  
      Returns
      -------
      Expr
          Expression of data type :class:`String`.
  
      Examples
      --------
      >>> df = pl.DataFrame({"strings": ["foo", "bar", None]})
      >>> df.with_columns(strings_hex=pl.col("strings").str.encode("hex"))
      shape: (3, 2)
      ┌─────────┬─────────────┐
      │ strings ┆ strings_hex │
      │ ---     ┆ ---         │
      │ str     ┆ str         │
      ╞═════════╪═════════════╡
      │ foo     ┆ 666f6f      │
      │ bar     ┆ 626172      │
      │ null    ┆ null        │
      └─────────┴─────────────┘
  
      """
      if encoding == "hex":
          return wrap_expr(self._pyexpr.str_hex_encode())
      elif encoding == "base64":
          return wrap_expr(self._pyexpr.str_base64_encode())
      else:
          raise ValueError(
              f"`encoding` must be one of {{'hex', 'base64'}}, got {encoding!r}"
          )
  
imports: from __future__ import annotations
  import warnings
  from typing import TYPE_CHECKING
  import polars._reexport
  from polars import functions
  from polars.datatypes import Date, Datetime, Int32, Time, py_type_to_dtype
  from polars.exceptions import ChronoFormatWarning
  from polars.utils._parse_expr_input import parse_as_expression
  from polars.utils._wrap import wrap_expr
  from polars.utils.deprecation import deprecate_renamed_function, deprecate_renamed_parameter, rename_use_earliest_to_ambiguous
  from polars.utils.various import find_stacklevel
label_desc: Use image node_id 27 for calling the ExprStringNameSpace obj's underlying member method code with example usage: obj.encode(encoding) and returns: wrap_expr, wrap_expr