macpie.lltools.filter_seq#

macpie.lltools.filter_seq(seq, items=None, like=None, regex=None, pred=None, invert=False)#

Filter sequence of strings. The options items, like, and regex are additive and can be used in conjunction with one another.

Parameters:
seqlist-like of strings

Sequence object to filter

itemslist-like

Get elements from seq which are in items.

likestr

Get elements from seq` for which “like in seq_element == True”.

regexstr (regular expression)

Get elements from seq` for which re.search(regex, seq_element) == True.

predBoolean-valued function

Get elements from seq` for which pred`(`seq_element) == True.

invertbool, default False

Whether to invert the result (i.e. filter out elements returned by items, like, regex, or pred)

Returns:
Tuple[List[str], List[int]]

(filtered_elements, filtered_element_indexes)

See also

filter_seq_pair