mirror of
https://github.com/m5stack/M5Stack_MicroPython.git
synced 2026-05-20 10:14:44 -07:00
Boris Lovosevic
b8fff81b45
'Ctrl+D' on empty line now performs full ESP32 soft reset 'math' module updated, added 'factorial' method 'uos' module updated, added 'mpycore' method to show MicroPython core git commit hash and date
103 lines
2.4 KiB
ReStructuredText
103 lines
2.4 KiB
ReStructuredText
:mod:`ure` -- simple regular expressions
|
|
========================================
|
|
|
|
.. module:: ure
|
|
:synopsis: regular expressions
|
|
|
|
|see_cpython_module| :mod:`python:re`.
|
|
|
|
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,
|
|
including negated sets (e.g. ``[^a-c]``).
|
|
|
|
``'^'``
|
|
|
|
``'$'``
|
|
|
|
``'?'``
|
|
|
|
``'*'``
|
|
|
|
``'+'``
|
|
|
|
``'??'``
|
|
|
|
``'*?'``
|
|
|
|
``'+?'``
|
|
|
|
``'|'``
|
|
|
|
``'(...)'``
|
|
Grouping. Each group is capturing (a substring it captures can be accessed
|
|
with `match.group()` method).
|
|
|
|
**NOT SUPPORTED**: Counted repetitions (``{m,n}``), more advanced assertions
|
|
(``\b``, ``\B``), named groups (``(?P<name>...)``), non-capturing groups
|
|
(``(?:...)``), etc.
|
|
|
|
|
|
Functions
|
|
---------
|
|
|
|
.. function:: compile(regex_str, [flags])
|
|
|
|
Compile regular expression, return `regex <regex>` object.
|
|
|
|
.. function:: match(regex_str, string)
|
|
|
|
Compile *regex_str* and match against *string*. Match always happens
|
|
from starting position in a string.
|
|
|
|
.. function:: search(regex_str, string)
|
|
|
|
Compile *regex_str* and search it 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.
|
|
(Availability depends on `MicroPython port`.)
|
|
|
|
|
|
.. _regex:
|
|
|
|
Regex objects
|
|
-------------
|
|
|
|
Compiled regular expression. Instances of this class are created using
|
|
`ure.compile()`.
|
|
|
|
.. method:: regex.match(string)
|
|
regex.search(string)
|
|
|
|
Similar to the module-level functions :meth:`match` and :meth:`search`.
|
|
Using methods is (much) more efficient if the same regex is applied to
|
|
multiple strings.
|
|
|
|
.. method:: regex.split(string, max_split=-1)
|
|
|
|
Split a *string* using regex. If *max_split* is given, it specifies
|
|
maximum number of splits to perform. Returns list of strings (there
|
|
may be up to *max_split+1* elements if it's specified).
|
|
|
|
Match objects
|
|
-------------
|
|
|
|
Match objects as returned by `match()` and `search()` methods.
|
|
|
|
.. method:: match.group([index])
|
|
|
|
Return matching (sub)string. *index* is 0 for entire match,
|
|
1 and above for each capturing group. Only numeric groups are supported.
|