Added regex flags to `search_regex` method

[JCGoran]

This PR adds the option to pass regex flags as a keyword argument to the search_regex method. I've also added a docstring to the same method to make the meaning of the kwargs argument clearer.