diff options
Diffstat (limited to 'Doc')
| -rw-r--r-- | Doc/lib/libre.tex | 43 |
1 files changed, 25 insertions, 18 deletions
diff --git a/Doc/lib/libre.tex b/Doc/lib/libre.tex index dc29b46..37c249e 100644 --- a/Doc/lib/libre.tex +++ b/Doc/lib/libre.tex @@ -93,8 +93,9 @@ The special characters are: character except a newline. If the \constant{DOTALL} flag has been specified, this matches any character including a newline. -\item[\character{\^}] (Caret.) Matches the start of the string, and in -\constant{MULTILINE} mode also matches immediately after each newline. +\item[\character{\textasciicircum}] (Caret.) Matches the start of the +string, and in \constant{MULTILINE} mode also matches immediately +after each newline. \item[\character{\$}] Matches the end of the string or just before the newline at the end of the string, and in \constant{MULTILINE} mode @@ -181,10 +182,14 @@ backslash, or place it as the first character. The pattern \regexp{[]]} will match \code{']'}, for example. You can match the characters not within a range by \dfn{complementing} -the set. This is indicated by including a \character{\^} as the first -character of the set; \character{\^} elsewhere will simply match the -\character{\^} character. For example, \regexp{[{\^}5]} will match -any character except \character{5}. +the set. This is indicated by including a +\character{\textasciicircum} as the first character of the set; +\character{\textasciicircum} elsewhere will simply match the +\character{\textasciicircum} character. For example, +\regexp{[{\textasciicircum}5]} will match +any character except \character{5}, and +\regexp{[\textasciicircum\code{\textasciicircum}]} will match any character +except \character{\textasciicircum}. \item[\character{|}]\code{A|B}, where A and B can be arbitrary REs, creates a regular expression that will match either A or B. An @@ -318,13 +323,13 @@ Python's string literals. equivalent to the set \regexp{[0-9]}. \item[\code{\e D}]Matches any non-digit character; this is -equivalent to the set \regexp{[{\^}0-9]}. +equivalent to the set \regexp{[{\textasciicircum}0-9]}. \item[\code{\e s}]Matches any whitespace character; this is equivalent to the set \regexp{[ \e t\e n\e r\e f\e v]}. \item[\code{\e S}]Matches any non-whitespace character; this is -equivalent to the set \regexp{[\^\ \e t\e n\e r\e f\e v]}. +equivalent to the set \regexp{[\textasciicircum\ \e t\e n\e r\e f\e v]}. \item[\code{\e w}]When the \constant{LOCALE} and \constant{UNICODE} flags are not specified, @@ -337,7 +342,7 @@ in the Unicode character properties database. \item[\code{\e W}]When the \constant{LOCALE} and \constant{UNICODE} flags are not specified, matches any non-alphanumeric character; this -is equivalent to the set \regexp{[{\^}a-zA-Z0-9_]}. With +is equivalent to the set \regexp{[{\textasciicircum}a-zA-Z0-9_]}. With \constant{LOCALE}, it will match any character not in the set \regexp{[0-9_]}, and not defined as a letter for the current locale. If \constant{UNICODE} is set, this will match anything other than @@ -361,7 +366,8 @@ semantics, the search operation is what you're looking for. See the regular expression objects. Note that match may differ from search using a regular expression -beginning with \character{\^}: \character{\^} matches only at the +beginning with \character{\textasciicircum}: +\character{\textasciicircum} matches only at the start of the string, or in \constant{MULTILINE} mode also immediately following a newline. The ``match'' operation succeeds only if the pattern matches at the start of the string regardless of mode, or at @@ -429,14 +435,14 @@ Make \regexp{\e w}, \regexp{\e W}, \regexp{\e b}, and \begin{datadesc}{M} \dataline{MULTILINE} -When specified, the pattern character \character{\^} matches at the -beginning of the string and at the beginning of each line -(immediately following each newline); and the pattern character +When specified, the pattern character \character{\textasciicircum} +matches at the beginning of the string and at the beginning of each +line (immediately following each newline); and the pattern character \character{\$} matches at the end of the string and at the end of each -line (immediately preceding each newline). By default, \character{\^} -matches only at the beginning of the string, and \character{\$} only -at the end of the string and immediately before the newline (if any) -at the end of the string. +line (immediately preceding each newline). By default, +\character{\textasciicircum} matches only at the beginning of the +string, and \character{\$} only at the end of the string and +immediately before the newline (if any) at the end of the string. \end{datadesc} \begin{datadesc}{S} @@ -623,7 +629,8 @@ attributes: The optional second parameter \var{pos} gives an index in the string where the search is to start; it defaults to \code{0}. This is not - completely equivalent to slicing the string; the \code{'\^'} pattern + completely equivalent to slicing the string; the + \code{'\textasciicircum'} pattern character matches at the real beginning of the string and at positions just after a newline, but not necessarily at the index where the search is to start. |