kopia lustrzana https://github.com/micropython/micropython
docs/ure: Document sub(), groups(), span(), start() and end().
rodzic
79d5e3abb3
commit
4727bd1db8
|
@ -64,6 +64,22 @@ Functions
|
||||||
string for first position which matches regex (which still may be
|
string for first position which matches regex (which still may be
|
||||||
0 if regex is anchored).
|
0 if regex is anchored).
|
||||||
|
|
||||||
|
.. function:: sub(regex_str, replace, string, count=0, flags=0)
|
||||||
|
|
||||||
|
Compile *regex_str* and search for it in *string*, replacing all matches
|
||||||
|
with *replace*, and returning the new string.
|
||||||
|
|
||||||
|
*replace* can be a string or a function. If it is a string then escape
|
||||||
|
sequences of the form ``\<number>`` and ``\g<number>`` can be used to
|
||||||
|
expand to the corresponding group (or an empty string for unmatched groups).
|
||||||
|
If *replace* is a function then it must take a single argument (the match)
|
||||||
|
and should return a replacement string.
|
||||||
|
|
||||||
|
If *count* is specified and non-zero then substitution will stop after
|
||||||
|
this many substitutions are made. The *flags* argument is ignored.
|
||||||
|
|
||||||
|
Note: availability of this function depends on `MicroPython port`.
|
||||||
|
|
||||||
.. data:: DEBUG
|
.. data:: DEBUG
|
||||||
|
|
||||||
Flag value, display debug information about compiled expression.
|
Flag value, display debug information about compiled expression.
|
||||||
|
@ -80,8 +96,10 @@ Compiled regular expression. Instances of this class are created using
|
||||||
|
|
||||||
.. method:: regex.match(string)
|
.. method:: regex.match(string)
|
||||||
regex.search(string)
|
regex.search(string)
|
||||||
|
regex.sub(replace, string, count=0, flags=0)
|
||||||
|
|
||||||
Similar to the module-level functions :meth:`match` and :meth:`search`.
|
Similar to the module-level functions :meth:`match`, :meth:`search`
|
||||||
|
and :meth:`sub`.
|
||||||
Using methods is (much) more efficient if the same regex is applied to
|
Using methods is (much) more efficient if the same regex is applied to
|
||||||
multiple strings.
|
multiple strings.
|
||||||
|
|
||||||
|
@ -94,9 +112,31 @@ Compiled regular expression. Instances of this class are created using
|
||||||
Match objects
|
Match objects
|
||||||
-------------
|
-------------
|
||||||
|
|
||||||
Match objects as returned by `match()` and `search()` methods.
|
Match objects as returned by `match()` and `search()` methods, and passed
|
||||||
|
to the replacement function in `sub()`.
|
||||||
|
|
||||||
.. method:: match.group([index])
|
.. method:: match.group([index])
|
||||||
|
|
||||||
Return matching (sub)string. *index* is 0 for entire match,
|
Return matching (sub)string. *index* is 0 for entire match,
|
||||||
1 and above for each capturing group. Only numeric groups are supported.
|
1 and above for each capturing group. Only numeric groups are supported.
|
||||||
|
|
||||||
|
.. method:: match.groups()
|
||||||
|
|
||||||
|
Return a tuple containing all the substrings of the groups of the match.
|
||||||
|
|
||||||
|
Note: availability of this method depends on `MicroPython port`.
|
||||||
|
|
||||||
|
.. method:: match.start([index])
|
||||||
|
match.end([index])
|
||||||
|
|
||||||
|
Return the index in the original string of the start or end of the
|
||||||
|
substring group that was matched. *index* defaults to the entire
|
||||||
|
group, otherwise it will select a group.
|
||||||
|
|
||||||
|
Note: availability of these methods depends on `MicroPython port`.
|
||||||
|
|
||||||
|
.. method:: match.span([index])
|
||||||
|
|
||||||
|
Returns the 2-tuple ``(match.start(index), match.end(index))``.
|
||||||
|
|
||||||
|
Note: availability of this method depends on `MicroPython port`.
|
||||||
|
|
Ładowanie…
Reference in New Issue