h9SSKJr SSKJr SSKJr SSKJr SSKJr \(aSSKJr \"SSS 9r "S S \\ 5r g ) ) annotations) TYPE_CHECKING)Any)Generic)TypeVar)SeriesSeriesTz Series[Any])boundc\rSrSrSSjrSSjrSSS.SSjjrSS.SS jjrSSS jjrSS jr SS jr SS.SSjjr SS Sjjr S!Sjr S"S#SjjrS"S#SjjrSSjrSSjrSS$SjjrSrg )%SeriesStringNamespacecXlgN_narwhals_series)selfseriess E/var/www/html/env/lib/python3.13/site-packages/narwhals/series_str.py__init__SeriesStringNamespace.__init__s &cURRURRRR 55$)aReturn the length of each string as the number of characters. Returns: A new Series containing the length of each string in characters. Examples: >>> import polars as pl >>> import narwhals as nw >>> s_native = pl.Series(["foo", "345", None]) >>> s = nw.from_native(s_native, series_only=True) >>> s.str.len_chars().to_native() # doctest: +NORMALIZE_WHITESPACE shape: (3,) Series: '' [u32] [ 3 3 null ] )r_with_compliant_compliant_seriesstr len_charsrs rrSeriesStringNamespace.len_charss;($$44  ! ! 3 3 7 7 A A C  rFliteralnc URRURRRR XX4S95$)aReplace first matching regex/literal substring with a new string value. Arguments: pattern: A valid regular expression pattern. value: String that will replace the matched substring. literal: Treat `pattern` as a literal string. n: Number of matches to replace. Returns: A new Series with the regex/literal pattern replaced with the specified value. Examples: >>> import pandas as pd >>> import narwhals as nw >>> s_native = pd.Series(["123abc", "abc abc123"]) >>> s = nw.from_native(s_native, series_only=True) >>> s.str.replace("abc", "").to_native() 0 123 1 abc123 dtype: object r )rrrrreplace)rpatternvaluer!r"s rr$SeriesStringNamespace.replace*sH0$$44  ! ! 3 3 7 7 ? ? @   rr!cURRURRRR XUS95$)a`Replace all matching regex/literal substring with a new string value. Arguments: pattern: A valid regular expression pattern. value: String that will replace the matched substring. literal: Treat `pattern` as a literal string. Returns: A new Series with all occurrences of pattern replaced with the specified value. Examples: >>> import pandas as pd >>> import narwhals as nw >>> s_native = pd.Series(["123abc", "abc abc123"]) >>> s = nw.from_native(s_native, series_only=True) >>> s.str.replace_all("abc", "").to_native() 0 123 1 123 dtype: object r()rrrr replace_all)rr%r&r!s rr*!SeriesStringNamespace.replace_allHsH*$$44  ! ! 3 3 7 7 C C D   rNcURRURRRR U55$)aRemove leading and trailing characters. Arguments: characters: The set of characters to be removed. All combinations of this set of characters will be stripped from the start and end of the string. If set to None (default), all leading and trailing whitespace is removed instead. Returns: A new Series with leading and trailing characters removed. Examples: >>> import polars as pl >>> import narwhals as nw >>> s_native = pl.Series(["apple", "\nmango"]) >>> s = nw.from_native(s_native, series_only=True) >>> s.str.strip_chars().to_native() # doctest: +NORMALIZE_WHITESPACE shape: (2,) Series: '' [str] [ "apple" "mango" ] )rrrr strip_chars)r characterss rr-!SeriesStringNamespace.strip_charscs=,$$44  ! ! 3 3 7 7 C CJ O  rcURRURRRR U55$)aCheck if string values start with a substring. Arguments: prefix: prefix substring Returns: A new Series with boolean values indicating if each string starts with the prefix. Examples: >>> import pandas as pd >>> import narwhals as nw >>> s_native = pd.Series(["apple", "mango", None]) >>> s = nw.from_native(s_native, series_only=True) >>> s.str.starts_with("app").to_native() 0 True 1 False 2 None dtype: object )rrrr starts_with)rprefixs rr1!SeriesStringNamespace.starts_with}s=($$44  ! ! 3 3 7 7 C CF K  rcURRURRRR U55$)aCheck if string values end with a substring. Arguments: suffix: suffix substring Returns: A new Series with boolean values indicating if each string ends with the suffix. Examples: >>> import pandas as pd >>> import narwhals as nw >>> s_native = pd.Series(["apple", "mango", None]) >>> s = nw.from_native(s_native, series_only=True) >>> s.str.ends_with("ngo").to_native() 0 False 1 True 2 None dtype: object )rrrr ends_with)rsuffixs rr5SeriesStringNamespace.ends_withs=($$44  ! ! 3 3 7 7 A A& I  rcURRURRRR XS95$)aCheck if string contains a substring that matches a pattern. Arguments: pattern: A Character sequence or valid regular expression pattern. literal: If True, treats the pattern as a literal string. If False, assumes the pattern is a regular expression. Returns: A new Series with boolean values indicating if each string contains the pattern. Examples: >>> import pyarrow as pa >>> import narwhals as nw >>> s_native = pa.chunked_array([["cat", "dog", "rabbit and parrot"]]) >>> s = nw.from_native(s_native, series_only=True) >>> s.str.contains("cat|parrot").to_native() # doctest: +ELLIPSIS [ [ true, false, true ] ] r()rrrrcontains)rr%r!s rr9SeriesStringNamespace.containss@4$$44  ! ! 3 3 7 7 @ @ @ Z  rcURRURRRR XS95$)aYCreate subslices of the string values of a Series. Arguments: offset: Start index. Negative indexing is supported. length: Length of the slice. If set to `None` (default), the slice is taken to the end of the string. Returns: A new Series containing subslices of each string. Examples: >>> import pandas as pd >>> import narwhals as nw >>> s_native = pd.Series(["pear", None, "papaya"]) >>> s = nw.from_native(s_native, series_only=True) >>> s.str.slice(4, 3).to_native() # doctest: +NORMALIZE_WHITESPACE 0 1 None 2 ya dtype: object offsetlengthrrrrslice)rr=r>s rr@SeriesStringNamespace.slicesE,$$44  ! ! 3 3 7 7 = = >   rcURRURRRR US95$)aSplit the string values of a Series by a substring. Arguments: by: Substring to split by. Returns: A new Series containing lists of strings. Examples: >>> import polars as pl >>> import narwhals as nw >>> s_native = pl.Series(["foo bar", "foo_bar"]) >>> s = nw.from_native(s_native, series_only=True) >>> s.str.split("_").to_native() # doctest: +NORMALIZE_WHITESPACE shape: (2,) Series: '' [list[str]] [ ["foo bar"] ["foo", "bar"] ] )by)rrrrsplit)rrCs rrDSeriesStringNamespace.splits@,$$44  ! ! 3 3 7 7 = = = D  rcURRURRRR SUS95$)azTake the first n elements of each string. Arguments: n: Number of elements to take. Negative indexing is supported (see note (1.)) Returns: A new Series containing the first n characters of each string. Notes: 1. When the `n` input is negative, `head` returns characters up to the n-th from the end of the string. For example, if `n = -3`, then all characters except the last three are returned. 2. If the length of the string has fewer than `n` characters, the full string is returned. Examples: >>> import pyarrow as pa >>> import narwhals as nw >>> s_native = pa.chunked_array([["taata", "taatatata", "zukkyun"]]) >>> s = nw.from_native(s_native, series_only=True) >>> s.str.head().to_native() # doctest: +ELLIPSIS [ [ "taata", "taata", "zukky" ] ] rr<r?rr"s rheadSeriesStringNamespace.headsB:$$44  ! ! 3 3 7 7 = =Qq = Q  rcURRURRRR U*SS95$)aTake the last n elements of each string. Arguments: n: Number of elements to take. Negative indexing is supported (see note (1.)) Returns: A new Series containing the last n characters of each string. Notes: 1. When the `n` input is negative, `tail` returns characters starting from the n-th from the beginning of the string. For example, if `n = -3`, then all characters except the first three are returned. 2. If the length of the string has fewer than `n` characters, the full string is returned. Examples: >>> import pyarrow as pa >>> import narwhals as nw >>> s_native = pa.chunked_array([["taata", "taatatata", "zukkyun"]]) >>> s = nw.from_native(s_native, series_only=True) >>> s.str.tail().to_native() # doctest: +ELLIPSIS [ [ "taata", "atata", "kkyun" ] ] Nr<r?rGs rtailSeriesStringNamespace.tail"sE:$$44  ! ! 3 3 7 7 = =aRPT = U  rcURRURRRR 55$)uMTransform string to uppercase variant. Returns: A new Series with values converted to uppercase. Notes: The PyArrow backend will convert 'ß' to 'ẞ' instead of 'SS'. For more info see: https://github.com/apache/arrow/issues/34599 There may be other unicode-edge-case-related variations across implementations. Examples: >>> import pandas as pd >>> import narwhals as nw >>> s_native = pd.Series(["apple", None]) >>> s = nw.from_native(s_native, series_only=True) >>> s.str.to_uppercase().to_native() 0 APPLE 1 None dtype: object )rrrr to_uppercasers rrN"SeriesStringNamespace.to_uppercaseCs;*$$44  ! ! 3 3 7 7 D D F  rcURRURRRR 55$)aiTransform string to lowercase variant. Returns: A new Series with values converted to lowercase. Examples: >>> import pandas as pd >>> import narwhals as nw >>> s_native = pd.Series(["APPLE", None]) >>> s = nw.from_native(s_native, series_only=True) >>> s.str.to_lowercase().to_native() 0 apple 1 None dtype: object )rrrr to_lowercasers rrQ"SeriesStringNamespace.to_lowercase\s; $$44  ! ! 3 3 7 7 D D F  rcURRURRRR US95$)uParse Series with strings to a Series with Datetime dtype. Notes: - pandas defaults to nanosecond time unit, Polars to microsecond. Prior to pandas 2.0, nanoseconds were the only time unit supported in pandas, with no ability to set any other one. The ability to set the time unit in pandas, if the version permits, will arrive. - timezone-aware strings are all converted to and parsed as UTC. Warning: As different backends auto-infer format in different ways, if `format=None` there is no guarantee that the result will be equal. Arguments: format: Format to use for conversion. If set to None (default), the format is inferred from the data. Returns: A new Series with datetime dtype. Examples: >>> import polars as pl >>> import narwhals as nw >>> s_native = pl.Series(["2020-01-01", "2020-01-02"]) >>> s = nw.from_native(s_native, series_only=True) >>> s.str.to_datetime( ... format="%Y-%m-%d" ... ).to_native() # doctest: +NORMALIZE_WHITESPACE shape: (2,) Series: '' [datetime[μs]] [ 2020-01-01 00:00:00 2020-01-02 00:00:00 ] )format)rrrr to_datetime)rrTs rrU!SeriesStringNamespace.to_datetimepsAH$$44  ! ! 3 3 7 7 C C6 C R  rr)rr returnNone)rWr ) r%rr&rr!boolr"intrWr )r%rr&rr!rYrWr r)r. str | NonerWr )r2rrWr )r6rrWr )r%rr!rYrWr )r=rZr>z int | NonerWr )rCrrWr ))r"rZrWr )rTr[rWr )__name__ __module__ __qualname____firstlineno__rrr$r*r-r1r5r9r@rDrHrKrNrQrU__static_attributes__rrr r s' 2 < 8 4 B B 2 (& & rr N) __future__rtypingrrrrnarwhals.seriesrr r rbrrrfs9" & )= 1H GG,H r