ak.str.match_like#
Defined in awkward.operations.str.akstr_match_like on line 13.
- ak.str.match_like(array, pattern, *, ignore_case=False, highlevel=True, behavior=None, attrs=None)#
- Parameters:
array – Array-like data (anything
ak.to_layout
recognizes).pattern (str or bytes) – SQL-style LIKE pattern to match against strings in
array
.ignore_case (bool) – If True, perform a case-insensitive match; otherwise, the match is case-sensitive.
highlevel (bool) – If True, return an
ak.Array
; otherwise, return a low-levelak.contents.Content
subclass.behavior (None or dict) – Custom
ak.behavior
for the output array, if high-level.attrs (None or dict) – Custom attributes for the output array, if high-level.
For each string in the array, determine whether it matches the given SQL-style LIKE pattern, which obeys the following rules:
‘%’ matches any number of characters.
‘_’ matches exactly one character.
Any other character matches itself.
To match a literal ‘%’, ‘_’, or “’”, the character must be preceded with a backslash.
Note: this function does not raise an error if the array
does not
contain any string or bytestring data.
Requires the pyarrow library and calls pyarrow.compute.match_like.