tabsdata.tableframe.expr.string.ExprStringNameSpace.contains#

ExprStringNameSpace.contains(pattern: str | Expr, *, literal: bool = False, strict: bool = True) → Expr[source]#

Evaluate if the string contains a pattern.

Parameters:

  • pattern – The pattern to search for.

  • literal – Take the pattern as a literal string (not a regex).

  • strict – if the given pattern is not valid regex, raise an error.

Example:

>>> import tabsdata as td
>>>
>>> tf: td.TableFrame ...
>>>
>>> tf.select(td.col("a"), td.col("a").str.contains("ab").alias("contains"))
>>>
┌──────┬──────────┐
│ a    ┆ contains │
│ ---  ┆ ---      │
│ str  ┆ bool     │
╞══════╪══════════╡
│ a    ┆ false    │
│ ab   ┆ true     │
│ b    ┆ false    │
│ xaby ┆ true     │
│ null ┆ null     │
└──────┴──────────┘