updated docstring example in v2 (test passed)

Author: msalvany

narwhals/stable/v2/__init__.py

@@ -917,14 +917,40 @@ def concat_str(
 
 
 def struct(exprs: IntoExpr | Iterable[IntoExpr], *more_exprs: IntoExpr) -> Expr:
-    """Horizontally combine multiple columns into a single struct column.
+    r"""Horizontally combine multiple columns into a single struct column.
 
     Arguments:
         exprs: One or more expressions to combine into a struct. Strings are treated as column names.
         *more_exprs: Additional columns or expressions, passed as positional arguments.
 
     Returns:
         An expression that produces a single struct column containing the given fields.
+
+    Example:
+        >>> import pandas as pd
+        >>> import narwhals as nw
+        >>>
+        >>> data = {
+        ...     "a": [1, 2, 3],
+        ...     "b": ["dogs", "cats", None],
+        ...     "c": ["play", "swim", "walk"],
+        ... }
+        >>> df_native = pd.DataFrame(data)
+        >>> (
+        ...     nw.from_native(df_native).select(
+        ...         nw.struct([nw.col("a") * 2, nw.col("b"), nw.col("c")]).alias(
+        ...             "my_struct"
+        ...         )
+        ...     )
+        ... )
+        ┌─────────────────────────────────────┐
+        |         Narwhals DataFrame          |
+        |-------------------------------------|
+        |                            my_struct|
+        |0  {'a': 2, 'b': 'dogs', 'c': 'play'}|
+        |1  {'a': 4, 'b': 'cats', 'c': 'swim'}|
+        |2    {'a': 6, 'b': None, 'c': 'walk'}|
+        └─────────────────────────────────────┘
     """
     return _stableify(nw.struct(exprs, *more_exprs))