83 lines
1.5 KiB
ReStructuredText
83 lines
1.5 KiB
ReStructuredText
|
:mod:`ure` -- regular expressions
|
||
|
|
=================================
|
||
|
|
|
||
|
|
.. module:: ure
|
||
|
|
:synopsis: regular expressions
|
||
|
|
|
||
|
|
This module implements regular expression operations. Regular expression
|
||
|
|
syntax supported is a subset of CPython ``re`` module (and actually is
|
||
|
|
a subset of POSIX extended regular expressions).
|
||
|
|
|
||
|
|
Supported operators are:
|
||
|
|
|
||
|
|
``'.'``
|
||
|
|
Match any character.
|
||
|
|
|
||
|
|
``'[]'``
|
||
|
|
Match set of characters. Individual characters and ranges are supported.
|
||
|
|
|
||
|
|
``'^'``
|
||
|
|
|
||
|
|
``'$'``
|
||
|
|
|
||
|
|
``'?'``
|
||
|
|
|
||
|
|
``'*'``
|
||
|
|
|
||
|
|
``'+'``
|
||
|
|
|
||
|
|
``'??'``
|
||
|
|
|
||
|
|
``'*?'``
|
||
|
|
|
||
|
|
``'+?'``
|
||
|
|
|
||
|
|
Counted repetitions (``{m,n}``), more advanced assertions, names groups,
|
||
|
|
etc. are not supported.
|
||
|
|
|
||
|
|
|
||
|
|
Functions
|
||
|
|
---------
|
||
|
|
|
||
|
|
.. function:: compile(regex)
|
||
|
|
|
||
|
|
Compile regular expression, return ``regex`` object.
|
||
|
|
|
||
|
|
.. function:: match(regex, string)
|
||
|
|
|
||
|
|
Match ``regex`` against ``string``. Match always happens from starting
|
||
|
|
position in a string.
|
||
|
|
|
||
|
|
.. function:: search(regex, string)
|
||
|
|
|
||
|
|
Search ``regex`` in a ``string``. Unlike ``match``, this will search
|
||
|
|
string for first position which matches regex (which still may be
|
||
|
|
0 if regex is anchored).
|
||
|
|
|
||
|
|
.. data:: DEBUG
|
||
|
|
|
||
|
|
Flag value, display debug information about compiled expression.
|
||
|
|
|
||
|
|
|
||
|
|
Regex objects
|
||
|
|
-------------
|
||
|
|
|
||
|
|
Compiled regular expression. Instances of this class are created using
|
||
|
|
``ure.compile()``.
|
||
|
|
|
||
|
|
.. method:: regex.match(string)
|
||
|
|
|
||
|
|
.. method:: regex.search(string)
|
||
|
|
|
||
|
|
.. method:: regex.split(string, max_split=-1)
|
||
|
|
|
||
|
|
|
||
|
|
Match objects
|
||
|
|
-------------
|
||
|
|
|
||
|
|
Match objects as returned by ``match()`` and ``search()`` methods.
|
||
|
|
|
||
|
|
.. method:: match.group([index])
|
||
|
|
|
||
|
|
Only numeric groups are supported.
|