Diffstat (limited to 'help/en/html/help/qregexp.html') (more/less context) (show whitespace changes)
-rw-r--r-- | help/en/html/help/qregexp.html | 75 |
1 files changed, 75 insertions, 0 deletions
diff --git a/help/en/html/help/qregexp.html b/help/en/html/help/qregexp.html new file mode 100644 index 0000000..f2dc0a3 --- a/dev/null +++ b/help/en/html/help/qregexp.html | |||
@@ -0,0 +1,75 @@ | |||
1 | <html><head><title>Pattern Matching</title></head><body> | ||
2 | <h1>Pattern Matching</h1> | ||
3 | Opie provides pattern matching using | ||
4 | <a href="#regexp">regular expressions</a> | ||
5 | or <a href="#wildcards">wildcards</a>.<br> | ||
6 | It supports <a href="#general">unicode</a> and | ||
7 | <a href="#general">character sets</a>. | ||
8 | <p> | ||
9 | <h2><a name="regexp"></a>Regular Expressions</h2> | ||
10 | Regular Expressions knows these primitives: | ||
11 | <ul plain> | ||
12 | <li><dfn>c</dfn> matches the character 'c' | ||
13 | <li><dfn>.</dfn> matches any character | ||
14 | <li><dfn>^</dfn> matches start of input | ||
15 | <li><dfn>$</dfn> matches end of input | ||
16 | <li><dfn>[]</dfn> matches a defined set of characters - see below. | ||
17 | <li><dfn>a*</dfn> matches a sequence of zero or more a's | ||
18 | <li><dfn>a+</dfn> matches a sequence of one or more a's | ||
19 | <li><dfn>a?</dfn> matches an optional a | ||
20 | <li><dfn>\c</dfn> escape code for matching special characters such | ||
21 | as \, [, *, +, . etc. | ||
22 | <li><dfn>\t</dfn> matches the TAB character (9) | ||
23 | <li><dfn>\n</dfn> matches newline (10) | ||
24 | <li><dfn>\r</dfn> matches return (13) | ||
25 | <li><dfn>\s</dfn> matches a white space (defined as any character | ||
26 | for which QChar::isSpace() returns TRUE. This includes at least | ||
27 | ASCII characters 9 (TAB), 10 (LF), 11 (VT), 12(FF), 13 (CR) and 32 | ||
28 | (Space)). | ||
29 | <li><dfn>\d</dfn> matches a digit (defined as any character for | ||
30 | which QChar::isDigit() returns TRUE. This includes at least ASCII | ||
31 | characters '0'-'9'). | ||
32 | <li><dfn>\x1f6b</dfn> matches the character with unicode point U1f6b | ||
33 | (hexadecimal 1f6b). \x0012 will match the ASCII/Latin1 character | ||
34 | 0x12 (18 decimal, 12 hexadecimal). | ||
35 | <li><dfn>\022</dfn> matches the ASCII/Latin1 character 022 (18 | ||
36 | decimal, 22 octal). | ||
37 | </ul> | ||
38 | <h2><a name="wildcards"></a>wildcard mode</h2> | ||
39 | <p>In wildcard mode, it only knows four primitives: | ||
40 | <ul plain> | ||
41 | <li><dfn>c</dfn> matches the character 'c' | ||
42 | <li><dfn>?</dfn> matches any character | ||
43 | <li><dfn>*</dfn> matches any sequence of characters | ||
44 | <li><dfn>[]</dfn> matches a defined set of characters - see below. | ||
45 | </ul> | ||
46 | <h2><a name="general">General</a></h2> | ||
47 | <p>It supports Unicode both in the pattern strings and in the | ||
48 | strings to be matched. | ||
49 | <p>A character set matches a defined set of characters. For example, | ||
50 | [BSD] matches any of 'B', 'D' and 'S'. Within a character set, the | ||
51 | special characters '.', '*', '?', '^', '$', '+' and '[' lose their | ||
52 | special meanings. The following special characters apply: | ||
53 | <ul plain> | ||
54 | <li><dfn>^</dfn> When placed first in the list, changes the | ||
55 | character set to match any character <em>not</em> in the list. To include | ||
56 | the character '^' itself in the set, escape it or place it anywhere | ||
57 | but first. | ||
58 | <li><dfn>-</dfn> Defines a range of characters. To include the | ||
59 | character '-' itself in the set, escape it or place it last. | ||
60 | <li><dfn>]</dfn> Ends the character set definition. To include the | ||
61 | character ']' itself in the set, escape it or place it first (but | ||
62 | after the negation operator '^', if present) | ||
63 | </ul> | ||
64 | Thus, [a-zA-Z0-9.] matches upper and lower case ASCII letters, | ||
65 | digits and dot; and [^\s] matches everything except white space. | ||
66 | <p>Bugs and limitations: | ||
67 | <ul> | ||
68 | <li>Case insensitive matching is not supported for non-ASCII/Latin1 | ||
69 | (non-8bit) characters. | ||
70 | </ul> | ||
71 | <br><br> | ||
72 | Taken from the Qt Documentation.<br> | ||
73 | This file is part of the Qt toolkit, | ||
74 | copyright © 1995-2001 Trolltech, all rights reserved. | ||
75 | </body></html> | ||