Qt wiki will be updated on October 12th 2023 starting at 11:30 AM (EEST) and the maintenance will last around 2-3 hours. During the maintenance the site will be unavailable.
Regexp engine in Qt5: Difference between revisions
Jump to navigation
Jump to search
m (Fixed general comments line in table Feature matrix) |
(Removed the cleanup tag as the page is now correct) |
||
(One intermediate revision by the same user not shown) | |||
Line 1: | Line 1: | ||
[[Category:Developing_Qt::Qt Planning::Qt Public Roadmap]] | [[Category:Developing_Qt::Qt Planning::Qt Public Roadmap]] | ||
Line 184: | Line 182: | ||
! RE2 | ! RE2 | ||
|- | |- | ||
! | ! \a | ||
|BELL | |BELL | ||
|✔ | |✔ | ||
Line 194: | Line 192: | ||
| | | | ||
|- | |- | ||
! | ! \A | ||
|beginning of input | |beginning of input | ||
| | | | ||
Line 204: | Line 202: | ||
| | | | ||
|- | |- | ||
! inside a [set] | ! \b inside a [set] | ||
|BACKSPACE | |BACKSPACE | ||
|? | |? | ||
Line 214: | Line 212: | ||
| | | | ||
|- | |- | ||
! outside a [set] | ! \b outside a [set] | ||
|on a word boundary | |on a word boundary | ||
|✔ | |✔ | ||
Line 224: | Line 222: | ||
| | | | ||
|- | |- | ||
! | ! \B | ||
|not on a word boundary | |not on a word boundary | ||
|✔ | |✔ | ||
Line 234: | Line 232: | ||
| | | | ||
|- | |- | ||
! | ! \cX | ||
|ASCII control character X | |ASCII control character X | ||
|✘ | |✘ | ||
Line 244: | Line 242: | ||
| | | | ||
|- | |- | ||
! | ! \d | ||
|digit | |digit | ||
|✔ | |✔ | ||
Line 254: | Line 252: | ||
| | | | ||
|- | |- | ||
! | ! \D | ||
|non digit | |non digit | ||
|✔ | |✔ | ||
Line 264: | Line 262: | ||
| | | | ||
|- | |- | ||
! | ! \e | ||
|ESCAPE | |ESCAPE | ||
|✘ | |✘ | ||
Line 274: | Line 272: | ||
| | | | ||
|- | |- | ||
! | ! \E | ||
|end of … quoting | |end of \Q … \E quoting | ||
|✘ | |✘ | ||
|✔ | |✔ | ||
Line 284: | Line 282: | ||
| | | | ||
|- | |- | ||
! | ! \f | ||
|FORM FEED | |FORM FEED | ||
|✔ | |✔ | ||
Line 294: | Line 292: | ||
| | | | ||
|- | |- | ||
! | ! \G | ||
|end of previous match | |end of previous match | ||
|✘ | |✘ | ||
Line 304: | Line 302: | ||
| | | | ||
|- | |- | ||
! | ! \n | ||
|LINE FEED | |LINE FEED | ||
|✔ | |✔ | ||
Line 314: | Line 312: | ||
| | | | ||
|- | |- | ||
! {x} | ! \N{x} | ||
|UNICODE CHARACTER NAME x | |UNICODE CHARACTER NAME x | ||
|✘ | |✘ | ||
Line 324: | Line 322: | ||
| | | | ||
|- | |- | ||
! {x} | ! \p{x} | ||
|UNICODE PROPERTY NAME x | |UNICODE PROPERTY NAME x | ||
|✘ | |✘ | ||
Line 334: | Line 332: | ||
| | | | ||
|- | |- | ||
! {x} | ! \P{x} | ||
|UNICODE PROPERTY NAME not x | |UNICODE PROPERTY NAME not x | ||
|✘ | |✘ | ||
Line 344: | Line 342: | ||
| | | | ||
|- | |- | ||
! | ! \Q | ||
|start of … quoting | |start of \Q … \E quoting | ||
|✘ | |✘ | ||
|✔ | |✔ | ||
Line 354: | Line 352: | ||
| | | | ||
|- | |- | ||
! | ! \r | ||
|CARRIAGE RETURN | |CARRIAGE RETURN | ||
|✔ | |✔ | ||
Line 364: | Line 362: | ||
| | | | ||
|- | |- | ||
! | ! \s | ||
|white space | |white space | ||
|✔ | |✔ | ||
Line 374: | Line 372: | ||
| | | | ||
|- | |- | ||
! | ! \S | ||
|non white space | |non white space | ||
|✔ | |✔ | ||
Line 384: | Line 382: | ||
| | | | ||
|- | |- | ||
! | ! \t | ||
|HORIZONTAL TAB | |HORIZONTAL TAB | ||
|✔ | |✔ | ||
Line 394: | Line 392: | ||
| | | | ||
|- | |- | ||
! | ! \uhhhh | ||
|U+hhhh (between U+0000 and U+FFFF) | |U+hhhh (between U+0000 and U+FFFF) | ||
|✘ | |✘ | ||
Line 404: | Line 402: | ||
| | | | ||
|- | |- | ||
! | ! \Uhhhhhhhh | ||
|U+hhhhhhhh (between U+00000000 and U+0010FFFF) | |U+hhhhhhhh (between U+00000000 and U+0010FFFF) | ||
|✘ | |✘ | ||
Line 414: | Line 412: | ||
| | | | ||
|- | |- | ||
! VERTICAL TAB | ! \v | ||
| VERTICAL TAB | |||
|✔ | |✔ | ||
|✔ | |✔ | ||
Line 423: | Line 422: | ||
| | | | ||
|- | |- | ||
! | ! \w | ||
|word character | |word character | ||
|✔ | |✔ | ||
Line 433: | Line 432: | ||
| | | | ||
|- | |- | ||
! | ! \W | ||
|non word character | |non word character | ||
|✔ | |✔ | ||
Line 443: | Line 442: | ||
| | | | ||
|- | |- | ||
! {hhhh} | ! \x{hhhh} | ||
|U+hhhh | |U+hhhh | ||
|✘ | |✘ | ||
Line 453: | Line 452: | ||
| | | | ||
|- | |- | ||
! | ! \xhhhh | ||
|U+hhhh | |U+hhhh | ||
|✔ (0000-FFFF) | |✔ (0000-FFFF) | ||
Line 463: | Line 462: | ||
| | | | ||
|- | |- | ||
! | ! \X | ||
|grapheme cluster | |grapheme cluster | ||
|✘ | |✘ | ||
Line 473: | Line 472: | ||
| | | | ||
|- | |- | ||
! | ! \Z | ||
|end of input (or before the final ) | |end of input (or before the final ) | ||
|✘ | |✘ | ||
Line 483: | Line 482: | ||
| | | | ||
|- | |- | ||
! | ! \z | ||
|end of input | |end of input | ||
|✘ | |✘ | ||
Line 493: | Line 492: | ||
| | | | ||
|- | |- | ||
! | ! \n | ||
|n-th backreference | |n-th backreference | ||
|✔ | |✔ | ||
Line 503: | Line 502: | ||
| | | | ||
|- | |- | ||
! | ! \0ooo | ||
|ASCII/Latin-1 character 0ooo | |ASCII/Latin-1 character 0ooo | ||
|✔ | |✔ | ||
Line 543: | Line 542: | ||
| | | | ||
|- | |- | ||
! quote the following symbol | ! \ | ||
|quote the following symbol | |||
|✔ | |✔ | ||
|✔ | |✔ | ||
Line 562: | Line 562: | ||
| | | | ||
|} | |} | ||
=== Supported syntax: Operators === | === Supported syntax: Operators === |
Latest revision as of 15:41, 22 May 2015
Regular expression engine in Qt5
This page summarizes the research for an alternative regular expression engine to be used in Qt 5.0. The discussion started on the qt5-feedback mailing list, cf.
- http://lists.qt-project.org/pipermail/qt5-feedback/2011-September/001004.html
- https://bugreports.qt.io/browse/QTBUG-20888
Current issues with QRegExp
From http://lists.qt-project.org/pipermail/qt5-feedback/2011-September/001054.html
High level issues
- QRegExp API is broken (see T7 in Low Level)
- QRegExp is used for QtScript though it does not fullfill the ECMAScript specification ECMA-262-1999 . Missing features include
- Non-greedy quantifiers (see page 141 titled "- 129 -")
- But current implementation of QtScript uses JSC which uses its own engine anyway, and only use QRegExp in its api as a container.
- Patternist/XPath also needs Regex features not found in QRegExp, including
- Non-greedy quantifiers ( http://www.w3.org/TR/xpath-functions/#regex-syntax )
- Qt Creator might want to offer multi-line Regex search- and replacing later. This cannot be efficient because of T6 described below. GtkSourceView has exactly that problem …
- Customer complained about QRegExp (though I don't see what's their exact problem):
- In their code they have RegExp? for matching emoticons. Unfortunately, they cannot use QRegExp? because of poor support for negative/positive lookahead. As a workaround they are using the PCRE (Perl Compatible Regular Expressions) library.
- Public task request:
- Lookbehind (T4) (bug 217916)
- Support for POSIX syntax (bug 218604)
- Removing const modifiers (T7) (bug 219234, bug 209041)
- Non-greedy quantifiers (T3) (bug 116127)
Low Level issues
- T1: ^ (caret) and $ (dollar) cannot match at each newline
- T2: . (dot) always matches newlines
- T3: lazy/non-greedy/reluctant quantifiers are not supported. this is not to be confused with minimal matching.
- T4: lookbehind is not supported (lookahead is)
- T5: lastIndexIn does not find that last match which indexIn would have found, e.g. lastIndexIn("abcd") for pattern ".*" returns 3, not 0
- T6: only linear input is supported, for a text editor like Kate this does not scale
- T7: QRegExp combines matcher and match object, despite the 1:n relation. As a consequence matching with a const QRegExp instance modifies a const object.
Future
- It must be a solid 3rd party engine — don't want to develop an in-house engine and maintain it.
- QRegExp likely to be moved into its own module in order to keep source compatibility.
- Addresses the above low-level issues (as much as possible).
- (Nice to have) At least the same syntax / features than std::regex
Proposed libraries
- PCRE
- "V8"
- ICU
- Boost.Regex
- std::regex (new in C+11)
- RE2
Feature matrix
QRegExp | PCRE | V8 | ICU | Boost.Regex | std::regex | RE2 | |
---|---|---|---|---|---|---|---|
General comments | See above. | ||||||
Already being used in Qt? | Yes | Indirectly as a GLIB dependency under Unix. Moreover, a stripped down version of PCRE is available inside WebKit (src/3rdparty/webkit/JavaScriptCore/pcre); all features not required by the JS specification were removed. | Yes (Qt 5) | libicui18n (optionally?) used by Qt 4.8 / Qt 5 in QLocale. | No | No | No |
Pros | Widely used, de-facto standard implementation for Perl-like regexps. | Uses UTF-16 natively. | very fast, use a DFA | ||||
Cons | Does not run on every platform supported by QtCore / QtBase[2]. | Boost does not give guarantees about ABI compatibility. | uses UTF-8, doesn't have the lookbehind neither lookahead | ||||
Fixes T1 | ✔ | ✔ | ✔ | ||||
Fixes T2 | ✔ | ✔ | ✔ | ||||
Fixes T3 | ✔ | ✔ | ? | ||||
Fixes T4 | ✔ | ✘ | ✘ | ||||
Fixes T5 | ? | ? | ✘ | ||||
Fixes T6 | ✔ ("by hand", with partial matching) | Maybe yes, see UText . | ✔ see StringPiece | ||||
Fixes T7 | ✔ | ✔ | ✘ |
✘✔
Supported syntax: Characters
QRegExp | PCRE | V8 | ICU | Boost.Regex | std::regex | RE2 | ||
---|---|---|---|---|---|---|---|---|
\a | BELL | ✔ | ✔ | ✔ | ||||
\A | beginning of input | ✔ | ✔ | |||||
\b inside a [set] | BACKSPACE | ? | ✔ | |||||
\b outside a [set] | on a word boundary | ✔ | ✔ | |||||
\B | not on a word boundary | ✔ | ✔ | ✔ | ||||
\cX | ASCII control character X | ✘ | ✔ | ✔ | ||||
\d | digit | ✔ | ✔ | ✔ | ||||
\D | non digit | ✔ | ✔ | ✔ | ||||
\e | ESCAPE | ✘ | ✔ | ✔ | ||||
\E | end of \Q … \E quoting | ✘ | ✔ | ✔ | ||||
\f | FORM FEED | ✔ | ✔ | ✔ | ||||
\G | end of previous match | ✘ | ✔ | ✔ | ||||
\n | LINE FEED | ✔ | ✔ | |||||
\N{x} | UNICODE CHARACTER NAME x | ✘ | ✘ | ✔ | ||||
\p{x} | UNICODE PROPERTY NAME x | ✘ | ✔ | ✔ | ||||
\P{x} | UNICODE PROPERTY NAME not x | ✘ | ✔ | ✔ | ||||
\Q | start of \Q … \E quoting | ✘ | ✔ | ✔ | ||||
\r | CARRIAGE RETURN | ✔ | ✔ | ✔ | ||||
\s | white space | ✔ | ✔ | ✔ | ||||
\S | non white space | ✔ | ✔ | ✔ | ||||
\t | HORIZONTAL TAB | ✔ | ✔ | ✔ | ||||
\uhhhh | U+hhhh (between U+0000 and U+FFFF) | ✘ | ✘ | |||||
\Uhhhhhhhh | U+hhhhhhhh (between U+00000000 and U+0010FFFF) | ✘ | ✘ | |||||
\v | VERTICAL TAB | ✔ | ✔ | ✘ | ||||
\w | word character | ✔ | ✔ | ✔ | ||||
\W | non word character | ✔ | ✔ | ✔ | ||||
\x{hhhh} | U+hhhh | ✘ | ✔ (0-10FFFF) | ✔ (0-10FFFF) | ||||
\xhhhh | U+hhhh | ✔ (0000-FFFF) | ✔ (00-FF) | ✔ (00-FF) | ||||
\X | grapheme cluster | ✘ | ✘ | |||||
\Z | end of input (or before the final ) | ✘ | ✔ | ✔ | ||||
\z | end of input | ✘ | ✔ | ✔ | ||||
\n | n-th backreference | ✔ | ✔ | |||||
\0ooo | ASCII/Latin-1 character 0ooo | ✔ | ✔ | |||||
. | any character but newlines | ✔ | ✔ | ✔ | ||||
^ | line beginning | ✔ | ✔ | ✔ | ||||
$ | line end | ✔ | ✔ | ✔ | ||||
\ | quote the following symbol | ✔ | ✔ | ✔ | ||||
[pattern] | set | ✔ | ✔ | ✔ |
Supported syntax: Operators
Operator | QRegExp | PCRE | V8 | ICU | Boost.Regex | std::regex | RE2 | |
---|---|---|---|---|---|---|---|---|
* | match 0 or more times | ✔ | ✔ | ✔ | ? | ? | ✔ | |
+ | match 1 or more times | ✔ | ✔ | ✔ | ✔ | |||
? | match 0 or 1 times | ✔ | ✔ | ✔ | ✔ | |||
{n} | match n times | ✔ | ✔ | ✔ | ✔ | |||
{n,} | match n or more times | ✔ | ✔ | ✔ | ✔ | |||
{n,m} | match between n and m times | ✔ | ✔ | ✔ | ✔ | |||
*? | match 0 or more times, not greedy | ✘ | ✔ | ✔ | ✔ | |||
? | match 1 or more times, not greedy | ✘ | ✔ | ✔ | ✔ | |||
?? | match 0 or 1 times, not greedy | ✘ | ✔ | ✔ | ✔ | |||
{n}? | match n times | ✘ | ✔ | ✔ | ✔ | |||
{n,}? | match n or more times, not greedy | ✘ | ✔ | ✔ | ✔ | |||
{n,m}? | match between n and m times, not greedy | ✘ | ✔ | ✔ | ✔ | |||
*+ | match 0 or more times, possessive | ✘ | ✔ | ✔ | ✘ | |||
+ | match 1 or more times, possessive | ✘ | ✔ | ✔ | ✘ | |||
? | match 0 or 1 times, possessive | ✘ | ✔ | ✔ | ✘ | |||
{n}+ | match n times | ✘ | ✔ | ✔ | ✘ | |||
{n,}+ | match n or more times, possessive | ✘ | ✔ | ✔ | ✘ | |||
{n,m}+ | match between n and m times, possessive | ✘ | ✔ | ✔ | ✘ | |||
( … ) | capturing group | ✔ | ✔ | ✔ | ✔ | |||
(?: … ) | group | ✔ | ✔ | ✔ | ✔ | |||
(?> … ) | atomic grouping | ✘ | ✔ | ✔ | ✘ | |||
(?# … ) | comment | ✘ | ✔ | ✔ | ✘ | |||
(?= … ) | look-ahead assertion | ✔ | ✔ | ✔ | ✘ | |||
(?! … ) | negative look-ahead assertion | ✔ | ✔ | ✔ | ✘ | |||
(?<= … ) | look-behind assertion | ✘ | ✔ | ✔ | ✘ | |||
(?<! … ) | negative look-behind assertion | ✘ | ✔ | ✔ | ✘ | |||
(?flags: … ) | flags change | ✘ | ✔ | ✔ | ||||
(?flags) | flags change | ✘ | ✔ | ✔ | ✔ | |||
(?P<name> …) | named capturing group | ✘ | ✔ | ✘ | ✔ | |||
(?<name> …) | named capturing group | ✘ | ✔ | ✘ | ✘ | |||
(?'name' …) | named capturing group | ✘ | ✔ | ✘ | ✘ | |||
…) | branch reset | ✘ | ✔ | ✘ | ✘ |
Supported syntax: flags
Flag | QRegExp | PCRE | V8 | ICU | Boost.Regex | std::regex | RE2 | |
---|---|---|---|---|---|---|---|---|
/i | case insensitive | ✔ | ✔ | ✔ | ✔ | |||
/m | multi-line | ✘ | ✔ | ✔ | ✔ | |||
/s | dot matches anything | ~[1] | ✔ | ✔ | ✔ | |||
/x | ignore whitespace and comments | ✘ | ✔ | ✔ | ✔ | |||
/U | minimal match | ✔ | ✔ | ✘ | ✔ |
Benchmarks
See https://gitorious.org/qt-regexp-benchmarks/qt-regexp-benchmarks for the code and https://gitorious.org/qt-regexp-benchmarks/pages/Home for some results.
- ↑ It's actually not possible to UNSET /s for QRegExp, i.e. making the dot not to match a newline.