source/text/shared/01/02100001.xhp | 257 ++++++++++++++++++++++++-------------
1 file changed, 167 insertions(+), 90 deletions(-)
New commits:
commit 41a83520a0f8a1a84619324291d3b1c1e2a2ee15
Author: Jay Bingham <bingha...@msn.com>
AuthorDate: Mon Jun 3 13:59:33 2019 -0300
Commit: Olivier Hallot <olivier.hal...@libreoffice.org>
CommitDate: Wed Jun 5 00:58:43 2019 +0200
Refactor RegExp Help page with improved contents
1) Mute some l10n strings
Change-Id: Ia7a2c1898491c0f0352c9c8df519bba057b3bab6
Reviewed-on: https://gerrit.libreoffice.org/73408
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hal...@libreoffice.org>
diff --git a/source/text/shared/01/02100001.xhp
b/source/text/shared/01/02100001.xhp
index b4d037dd5..1f4b2dc77 100644
--- a/source/text/shared/01/02100001.xhp
+++ b/source/text/shared/01/02100001.xhp
@@ -27,6 +27,11 @@
<body>
<bookmark xml-lang="en-US" branch="index" id="bm_id3146765">
<bookmark_value>regular expressions; list of</bookmark_value>
+<bookmark_value>regular expressions; new line</bookmark_value>
+<bookmark_value>regular expressions; empty paragraph</bookmark_value>
+<bookmark_value>regular expressions; begin of word</bookmark_value>
+<bookmark_value>regular expressions; begin of paragraph</bookmark_value>
+<bookmark_value>regular expressions; end of paragraph</bookmark_value>
<bookmark_value>lists; regular expressions</bookmark_value>
<bookmark_value>replacing; tab stops (regular expressions)</bookmark_value>
<bookmark_value>tab stops; regular expressions</bookmark_value>
@@ -37,10 +42,10 @@
<table id="tbl_id3149517">
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3149741"
role="tablehead">Character</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3149741"
role="tablehead">Term</paragraph>
</tablecell>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3155577"
role="tablehead">Result/Use</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3155577"
role="tablehead">Representation/Use</paragraph>
</tablecell>
</tablerow>
<tablerow>
@@ -48,96 +53,100 @@
<paragraph xml-lang="en-US" id="par_id6600543" role="tablecontent">Any
character</paragraph>
</tablecell>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id9824518.00000001"
role="tablecontent">Represents the given character unless otherwise
specified.</paragraph>
+ <paragraph xml-lang="en-US" id="par_id9824518.00000001"
role="tablecontent">The given character unless it is a regular expression meta
character, which follow in this table.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" localize="false" id="par_id3152427"
role="tablecontent">.</paragraph>
+ <paragraph localize="false" id="par_id3152427"
role="tablecontent">.</paragraph>
</tablecell>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3149031"
role="tablecontent">Represents any single character except for a line break or
paragraph break. For example, the search term "sh.rt" returns both "shirt" and
"short".</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3149031" role="tablecontent">Any
single character except a line break or a paragraph break. For example, the
search term "sh.rt" matches both "shirt" and "short".</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" localize="false" id="par_id3154682"
role="tablecontent">^</paragraph>
+ <paragraph localize="false" id="par_id3154682"
role="tablecontent">^</paragraph>
</tablecell>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3155351" role="tablecontent">Only
finds the search term if the term is at the beginning of a paragraph. Special
objects such as empty fields or character-anchored frames, at the beginning of
a paragraph are ignored. Example: "^Peter".</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3155351" role="tablecontent">The
beginning of a paragraph or cell. Special objects such as empty fields or
character-anchored frames, at the beginning of a paragraph are ignored.
Example: "^Peter" matches the word "Peter" only when it is the first word of a
paragraph.
+ </paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3159194" localize="false"
role="tablecontent">$</paragraph>
+ <paragraph id="par_id3159194" localize="false"
role="tablecontent">$</paragraph>
</tablecell>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3152542" role="tablecontent">Only
finds the search term if the term appears at the end of a paragraph. Special
objects such as empty fields or character-anchored frames at the end of a
paragraph are ignored. Example: "Peter$".</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3152542" role="tablecontent">The
end of a paragraph or cell. Special objects such as empty fields or
character-anchored frames at the end of a paragraph are ignored. Example:
"Peter$" matches only when the word "Peter" is the last word of a paragraph,
note "Peter" cannot be followed by a period.</paragraph>
<paragraph xml-lang="en-US" id="par_id3152543" role="tablecontent">$ on
its own matches the end of a paragraph. This way it is possible to search and
replace paragraph breaks.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3156414" role="tablecontent"
localize="false">*</paragraph>
+ <paragraph id="par_id3156414" role="tablecontent"
localize="false">*</paragraph>
</tablecell>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3155555" role="tablecontent">Finds
zero or more of the characters in front of the "*". For example, "Ab*c" finds
"Ac", "Abc", "Abbc", "Abbbc", and so on.</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3155555"
role="tablecontent">Zero or more of the regular expression term immediately
preceding it. For example, "Ab*c" matches "Ac", "Abc", "Abbc", "Abbbc", and so
on.
+ </paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3147399" localize="false"
role="tablecontent">+</paragraph>
+ <paragraph id="par_id3147399" localize="false"
role="tablecontent">+</paragraph>
</tablecell>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3157958" role="tablecontent">Finds
one or more of the characters in front of the "+". For example, "AX.+4" finds
"AXx4", but not "AX4".</paragraph>
- <paragraph xml-lang="en-US" id="par_id3145313" role="tablecontent">The
longest possible string that matches this search pattern in a paragraph is
always found. If the paragraph contains the string "AX 4 AX4", the entire
passage is highlighted.</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3157958" role="tablecontent">One
or more of the regular expression term immediately preceding it. For example,
"AX.+4" finds "AXx4", but not "AX4".</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3145313" role="tablecontent">The
longest possible string that matches this regular expression in a paragraph is
always matched. If the paragraph contains the string "AX 4 AX4", the entire
passage is highlighted.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3143267" localize="false"
role="tablecontent">?</paragraph>
+ <paragraph id="par_id3143267" localize="false"
role="tablecontent">?</paragraph>
</tablecell>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3153684" role="tablecontent">Finds
zero or one of the characters in front of the "?". For example, "Texts?" finds
"Text" and "Texts" and "x(ab|c)?y" finds "xy", "xaby", or "xcy".</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3153684"
role="tablecontent">Zero or one of the regular expression term immediately
preceding it. For example, "Texts?" matches "Text" and "Texts" and "x(ab|c)?y"
finds "xy", "xaby", or "xcy".</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3166410" localize="false"
role="tablecontent">\</paragraph>
+ <paragraph id="par_id3166410" localize="false"
role="tablecontent">\</paragraph>
</tablecell>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3147209"
role="tablecontent">Search interprets the special character that follows the
"\" as a normal character and not as a regular expression (except for the
combinations \n, \t, \>, and \<). For example, "tree\." finds "tree.",
not "treed" or "trees".</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3147209" role="tablecontent">The
special character that follows it is interpreted as a normal character and not
as a regular expression meta character (except for the combinations "\n", "\t",
"\b", "\>" and "\<"). For example, "tree\." matches "tree.", not "treed"
or "trees".</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3152945" localize="false"
role="tablecontent">\n</paragraph>
+ <paragraph id="par_id3152945" localize="false"
role="tablecontent">\n</paragraph>
</tablecell>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3153700"
role="tablecontent">Represents a line break that was inserted with the
<emph>Shift</emph>+<emph>Enter</emph> key combination. To change a line break
into a paragraph break, enter <emph>\n</emph> in the <emph>Find</emph> and
<emph>Replace</emph> boxes, and then perform a search and replace.</paragraph>
- <paragraph xml-lang="en-US" id="par_id9262672"
role="tablecontent"><emph>\n</emph> in the <emph>Find</emph> text box stands
for a line break that was inserted with the
<emph>Shift</emph>+<emph>Enter</emph> key combination.</paragraph>
- <paragraph xml-lang="en-US" id="par_id2366100"
role="tablecontent"><emph>\n</emph> in the <emph>Replace</emph> text box stands
for a paragraph break that can be entered with the <emph>Enter</emph> or
<emph>Return</emph> key.</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3153700" role="tablecontent">A
line break that was inserted with the <keycode>Shift+Enter</keycode> key
combination when in the <widget>Find</widget> text box. </paragraph>
+ <paragraph role="tablecontent" id="par_id731559575258580">A paragraph
break that can be entered with the <keycode>Enter</keycode> or
<keycode>Return</keycode> key when in the <widget>Replace</widget> text
box.</paragraph>
+ <paragraph role="tablecontent" id="par_id631559575338134">To change
line breaks into paragraph breaks, enter \n in both the <widget>Find</widget>
and <widget>Replace</widget> boxes, and then perform a search and
replace.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3153258" localize="false"
role="tablecontent">\t</paragraph>
+ <paragraph id="par_id3153258" localize="false"
role="tablecontent">\t</paragraph>
</tablecell>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3157809"
role="tablecontent">Represents a tab. You can also use this expression in the
<emph>Replace</emph> box.</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3157809" role="tablecontent">A
tab character. Can also be used in the <widget>Replace</widget> box.
+ </paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3150670" localize="false"
role="tablecontent">\b</paragraph>
+ <paragraph id="par_id3150670" localize="false"
role="tablecontent">\b</paragraph>
</tablecell>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3153666" role="tablecontent">Match
a word boundary. For example, "\bbook" finds "bookmark" but not "checkbook"
whereas "book\b" finds "checkbook" but not "bookmark". The discrete word "book"
is found by both search terms.</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3153666" role="tablecontent">A
word boundary. For example, "\bbook" matches "bookmark" and "book" but not
"checkbook" whereas "book\b" matches "checkbook" and "book" but not
"bookmark".</paragraph>
+ <paragraph role="tablecontent" id="par_id851559575484466">Note, this
form replaces the obsolete (although they still work for now) forms "\>"
(match end of word) and "\<" (match start of word).</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3149576" localize="false"
role="tablecontent">^$</paragraph>
+ <paragraph id="par_id3149576" localize="false"
role="tablecontent">^$</paragraph>
</tablecell>
<tablecell>
<paragraph xml-lang="en-US" id="par_id3151245" role="tablecontent">Finds
an empty paragraph.</paragraph>
@@ -145,7 +154,7 @@
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3148550" localize="false"
role="tablecontent">^.</paragraph>
+ <paragraph id="par_id3148550" localize="false"
role="tablecontent">^.</paragraph>
</tablecell>
<tablecell>
<paragraph xml-lang="en-US" id="par_id3159413" role="tablecontent">Finds
the first character of a paragraph.</paragraph>
@@ -156,103 +165,94 @@
<paragraph xml-lang="en-US" id="par_id3147282" role="tablecontent">&
or $0</paragraph>
</tablecell>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3153961" role="tablecontent">Adds
the string that was found by the search criteria in the <emph>Find</emph> box
to the term in the <emph>Replace</emph> box when you make a
replacement.</paragraph>
- <paragraph xml-lang="en-US" id="par_id3149650" role="tablecontent">For
example, if you enter "window" in the <emph>Find</emph> box and "&frame" in
the <emph>Replace</emph> box, the word "window" is replaced with
"windowframe".</paragraph>
- <paragraph xml-lang="en-US" id="par_id3150543" role="tablecontent">You
can also enter an "&" in the <emph>Replace</emph> box to modify the
<emph>Attributes</emph> or the <emph>Format</emph> of the string found by the
search criteria.</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3153961"
role="tablecontent">Adds the string that was found by the search criteria in
the <widget>Find</widget> box to the term in the <widget>Replace</widget> box
when you make a replacement.</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3149650" role="tablecontent">For
example, if you enter "window" in the <widget>Find</widget> box and
"&frame" in the <widget>Replace</widget> box, the word "window" is replaced
with "windowframe".</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3150543" role="tablecontent">You
can also enter an "&" in the <widget>Replace</widget> box to modify the
<emph>Attributes</emph> or the <emph>Format</emph> of the string found by the
search criteria.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3145419" localize="false"
role="tablecontent">[abc123]</paragraph>
+ <paragraph id="par_id3145419" localize="false"
role="tablecontent">[...]</paragraph>
</tablecell>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3154630"
role="tablecontent">Represents one of the characters that are between the
brackets.</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3154630" role="tablecontent">Any
single occurrence of any one of the characters that are between the brackets.
For example: "[abc123]" matches the characters ‘a’, ‘b’, ’c’, ‘1’, ‘2’ and
‘3’. "[a-e]" matches single occurrences of the characters a through e,
inclusive (the range must be specified with the character having the smallest
Unicode code number first). "[a-eh-x]" matches any single occurrence of the
characters that are in the ranges ‘a’ through ‘e’ and ‘h’ through
‘x’.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3156293" localize="false"
role="tablecontent">[a-e]</paragraph>
+ <paragraph id="par_id3156293" localize="false"
role="tablecontent">[^...]</paragraph>
</tablecell>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3149167"
role="tablecontent">Represents any of the characters that are between
<emph>a</emph> and <emph>e</emph>, including both start and end
characters.</paragraph>
- <paragraph xml-lang="en-US" id="par_id100520090232005"
role="tablecontent">The characters are ordered by their code
numbers.</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3149167" role="tablecontent">Any
single occurrence of a character, including Tab, Space and Line Break
characters, that is not in the list of characters specified inclusive ranges
are permitted. For example "[^a-syz]" matches all characters not in the
inclusive range ‘a’ through ‘s’ or the characters ‘y’ and ‘z’.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3155994" localize="false"
role="tablecontent">[a-eh-x]</paragraph>
+ <paragraph id="par_id3156543" localize="false"
role="tablecontent">\uXXXX</paragraph>
+ <paragraph id="par_id3156544" localize="false"
role="tablecontent">\UXXXXXXXX</paragraph>
</tablecell>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3148676"
role="tablecontent">Represents any of the characters that are between
<emph>a-e</emph> and <emph>h-x</emph>.</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3153768" role="tablecontent">The
character represented by the four-digit hexadecimal Unicode code
(XXXX).</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3153769" role="tablecontent">The
character represented by the eight-digit hexadecimal Unicode code
(XXXXXXXX).</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3159252" role="tablecontent">For
certain symbol fonts the Unicode code for special characters may depend on the
font in use. The Unicode codes can be viewed by choosing <menuitem>Insert -
Special Character</menuitem>.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3145318" localize="false"
role="tablecontent">[^a-s]</paragraph>
+ <paragraph id="par_id3153951" localize="false"
role="tablecontent">|</paragraph>
</tablecell>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3153351"
role="tablecontent">Represents everything that is <emph>not</emph> between
<emph>a</emph> and <emph>s</emph>.</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3154985" role="tablecontent">The
infix operator delimiting alternatives. Matches the term preceding the "|" or
the term following the "|". For example, "this|that" matches occurrences of
both "this" and "that".</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3156543" localize="false"
role="tablecontent">\uXXXX</paragraph>
- <paragraph xml-lang="en-US" id="par_id3156544" localize="false"
role="tablecontent">\UXXXXXXXX</paragraph>
+ <paragraph id="par_id3147376" localize="false"
role="tablecontent">{N}</paragraph>
</tablecell>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3153768"
role="tablecontent">Represents a character based on its four-digit hexadecimal
Unicode code (XXXX).</paragraph>
- <paragraph xml-lang="en-US" id="par_id3153769" role="tablecontent">For
obscure characters there is a separate variant with capital U and eight
hexadecimal digits (XXXXXXXX).</paragraph>
- <paragraph xml-lang="en-US" id="par_id3159252" role="tablecontent">For
certain symbol fonts the code for special characters may depend on the used
font. You can view the codes by choosing <emph>Insert - Special
Character</emph>.</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3150103" role="tablecontent">The
post-fix repetition operator that specifies an exact number of occurrences
("N") of the regular expression term immediately preceding it must be present
for a match to occur. For example, "tre{2}" matches "tree".</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3153951" localize="false"
role="tablecontent">|</paragraph>
+ <paragraph id="par_id3151289" localize="false"
role="tablecontent">{N,M}</paragraph>
</tablecell>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3154985" role="tablecontent">Finds
the terms that occur before the "|" and also finds the terms that occur after
the "|". For example, "this|that" finds "this" and "that".</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3147317" role="tablecontent">The
post-fix repetition operator that specifies a range (minimum of "N" to a
maximum of "M") of occurrences of the regular expression term immediately
preceding it that can be present for a match to occur. For example, "tre{1,2}"
marches "tre" and "tree".</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3147376" localize="false"
role="tablecontent">{2}</paragraph>
+ <paragraph id="par_id4870754" localize="false"
role="tablecontent">{N,}</paragraph>
</tablecell>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3150103"
role="tablecontent">Defines the number of times that the character in front of
the opening bracket occurs. For example, "tre{2}" finds and selects
"tree".</paragraph>
+ <paragraph xml-lang="en-US" id="par_id843836" role="tablecontent">The
post-fix repetition operator that specifies a range (minimum "N" to an
unspecified maximum) of occurrences of the regular expression term immediately
preceding it that can be present for a match to occur. (The maximum number of
occurrences is limited only by the size of the document). For example,
"tre{2,}" matches "tree", "treee", and "treeeee".</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3151289" localize="false"
role="tablecontent">{1,2}</paragraph>
+ <paragraph id="par_id3148616" localize="false"
role="tablecontent">(...)</paragraph>
</tablecell>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3147317"
role="tablecontent">Defines the minimum and maximum number of times that the
character in front of the opening bracket can occur. For example, "tre{1,2}"
finds and selects "tre" and "tree".</paragraph>
+ <paragraph role="paragraph" id="par_id91559576682961">The grouping
construct that serves three purposes.</paragraph>
+ <list type="ordered">
+ <listitem>
+ <paragraph id="par_id871559576709007" role="listitem">To
enclose a set of ‘|’ alternatives. For example, the regular expression
"b(oo|ac)k" matches both "book" and "back".</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id891559576747109" role="listitem">To
group terms in a complex expression to be operated on by the post-fix
operators: "*", "+" and "?" along with the post-fix repetition operators. For
example, the regular expression "a(bc)?d" matches both "ad" and "abcd" in a
search.; the regular expression "M(iss){2}ippi" matches
"Mississippi".</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id801559576780692" role="listitem">To
record the matched sub string inside the parentheses as a reference for later
use in the <widget>Find</widget> box using the "\n" construct or in the
<widget>Replace</widget> box using the "$n" construct, where the reference to
the first matched sub string in the current expression in the
<widget>Find</widget> box is represented by "\1" in the <widget>Find</widget>
box and by "$1" in the <widget>Replace</widget> box, the reference to the
second matched sub string by "\2" and "$2" respectively, and so on.</paragraph>
+ </listitem>
+ </list>
+ <paragraph role="paragraph" id="par_id951559576846997">For example,
the regular expression "(890)7\1\1" matches "8907890890".</paragraph>
+ <paragraph role="paragraph" id="par_id561559576865734">With the
regular expression "\b(fruit|truth)\b" in the Find box and the regular
expression "$1ful" in the Replace box occurrences of the words "fruit" and
"truth" can be replaced with the words "fruitful" and "truthful" respectively
without affecting the words "fruitfully" and "truthfully"</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id4870754" localize="false"
role="tablecontent">{1,}</paragraph>
- </tablecell>
- <tablecell>
- <paragraph xml-lang="en-US" id="par_id843836"
role="tablecontent">Defines the minimum number of times that the character in
front of the opening bracket can occur. For example, "tre{2,}" finds "tree",
"treee", and "treeeee".</paragraph>
- </tablecell>
- </tablerow>
- <tablerow>
- <tablecell>
- <paragraph xml-lang="en-US" id="par_id3148616" localize="false"
role="tablecontent">( )</paragraph>
- </tablecell>
- <tablecell>
- <paragraph xml-lang="en-US" id="par_id2701803" role="tablecontent">In
the <emph>Find</emph> box:</paragraph>
- <paragraph xml-lang="en-US" id="par_id3153573"
role="tablecontent">Defines the characters inside the parentheses as a
reference. You can then refer to the first reference in the current expression
with "\1", to the second reference with "\2", and so on.</paragraph>
- <paragraph xml-lang="en-US" id="par_id3156061" role="tablecontent">For
example, if your text contains the number <emph>13487889</emph> and you search
using the regular expression <emph>(8)7\1\1</emph>, "8788" is found.</paragraph>
- <paragraph xml-lang="en-US" id="par_id2367931" role="tablecontent">You
can also use <emph>()</emph> to group terms, for example, "a(bc)?d" finds "ad"
or "abcd".</paragraph>
- <paragraph xml-lang="en-US" id="par_id9200109" role="tablecontent">In
the <emph>Replace</emph> box:<comment>i83322</comment></paragraph>
- <paragraph xml-lang="en-US" id="par_id5766472" role="tablecontent">Use
<emph>$</emph> (dollar) instead of <emph>\</emph> (backslash) to replace
references. Use <emph>$0</emph> to replace the whole found string.</paragraph>
- </tablecell>
- </tablerow>
- <tablerow>
- <tablecell>
- <paragraph xml-lang="en-US" id="par_id3154790" localize="false"
role="tablecontent">[:alpha:]</paragraph>
+ <paragraph id="par_id3154790" localize="false"
role="tablecontent">[:alpha:]</paragraph>
</tablecell>
<tablecell>
<paragraph xml-lang="en-US" id="par_id3147397"
role="tablecontent">Represents an alphabetic character. Use
<emph>[:alpha:]+</emph> to find one of them.</paragraph>
@@ -260,7 +260,7 @@
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3152885" localize="false"
role="tablecontent">[:digit:]</paragraph>
+ <paragraph id="par_id3152885" localize="false"
role="tablecontent">[:digit:]</paragraph>
</tablecell>
<tablecell>
<paragraph xml-lang="en-US" id="par_id3150010"
role="tablecontent">Represents a decimal digit. Use <emph>[:digit:]+</emph> to
find one of them.</paragraph>
@@ -268,7 +268,7 @@
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3153743" localize="false"
role="tablecontent">[:alnum:]</paragraph>
+ <paragraph id="par_id3153743" localize="false"
role="tablecontent">[:alnum:]</paragraph>
</tablecell>
<tablecell>
<paragraph xml-lang="en-US" id="par_id3153281"
role="tablecontent">Represents an alphanumeric character ([:alpha:] and
[:digit:]).</paragraph>
@@ -276,7 +276,7 @@
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3153726" localize="false"
role="tablecontent">[:space:]</paragraph>
+ <paragraph id="par_id3153726" localize="false"
role="tablecontent">[:space:]</paragraph>
</tablecell>
<tablecell>
<paragraph xml-lang="en-US" id="par_id3150961"
role="tablecontent">Represents a space character (but not other whitespace
characters).<comment>UFI: see #i41706#</comment></paragraph>
@@ -284,7 +284,7 @@
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3150486" localize="false"
role="tablecontent">[:print:]</paragraph>
+ <paragraph id="par_id3150486" localize="false"
role="tablecontent">[:print:]</paragraph>
</tablecell>
<tablecell>
<paragraph xml-lang="en-US" id="par_id3150872"
role="tablecontent">Represents a printable character.</paragraph>
@@ -292,7 +292,7 @@
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3155854" localize="false"
role="tablecontent">[:cntrl:]</paragraph>
+ <paragraph id="par_id3155854" localize="false"
role="tablecontent">[:cntrl:]</paragraph>
</tablecell>
<tablecell>
<paragraph xml-lang="en-US" id="par_id3152576"
role="tablecontent">Represents a nonprinting character.</paragraph>
@@ -300,7 +300,7 @@
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3149958" localize="false"
role="tablecontent">[:lower:]</paragraph>
+ <paragraph id="par_id3149958" localize="false"
role="tablecontent">[:lower:]</paragraph>
</tablecell>
<tablecell>
<paragraph xml-lang="en-US" id="par_id3145730"
role="tablecontent">Represents a lowercase character if <emph>Match case</emph>
is selected in <emph>Options</emph>.</paragraph>
@@ -308,7 +308,7 @@
</tablerow>
<tablerow>
<tablecell>
- <paragraph xml-lang="en-US" id="par_id3148455" localize="false"
role="tablecontent">[:upper:]</paragraph>
+ <paragraph id="par_id3148455" localize="false"
role="tablecontent">[:upper:]</paragraph>
</tablecell>
<tablecell>
<paragraph xml-lang="en-US" id="par_id3150092"
role="tablecontent">Represents an uppercase character if <emph>Match
case</emph> is selected in <emph>Options</emph>.</paragraph>
@@ -316,16 +316,93 @@
</tablerow>
</table>
<paragraph xml-lang="en-US" id="par_id5311440" role="paragraph">For a full
list of supported metacharacters and syntax, see <link
href="http://userguide.icu-project.org/strings/regexp"; name="ICU Regular
Expressions documentation">ICU Regular Expressions
documentation</link></paragraph>
-<paragraph xml-lang="en-US" id="hd_id5311441" role="heading"
level="2">Examples</paragraph>
-<paragraph xml-lang="en-US" id="par_id956834773" role="paragraph"><item
type="input">e([:digit:])?</item> -- finds 'e' followed by zero or one
digit. Note that currently all named character classes like [:digit:] must be
enclosed in parentheses.<comment>issue 64368 and 113035</comment></paragraph>
-<paragraph xml-lang="en-US" id="par_id952368773" role="paragraph"><item
type="input">^([:digit:])$</item> -- finds lines or cells with exactly one
digit.</paragraph>
- <paragraph xml-lang="en-US" id="par_id9568773" role="paragraph">You can
combine the search terms to form complex searches.</paragraph>
-<paragraph xml-lang="en-US" id="hd_id71413" role="heading" level="3">To find
three-digit numbers alone in a paragraph</paragraph>
-<paragraph xml-lang="en-US" id="par_id2924283" localize="false"
role="paragraph"><item type="input">^[:digit:]{3}$</item> </paragraph>
- <paragraph xml-lang="en-US" id="par_id5781731" role="paragraph">^ means the
match has to be at the start of a paragraph, </paragraph>
- <paragraph xml-lang="en-US" id="par_id6942045" role="paragraph">[:digit:]
matches any decimal digit, </paragraph>
- <paragraph xml-lang="en-US" id="par_id4721823" role="paragraph">{3} means
there must be exactly 3 copies of "digit", </paragraph>
- <paragraph xml-lang="en-US" id="par_id5806756" role="paragraph">$ means the
match must end a paragraph. </paragraph>
+<paragraph role="paragraph" id="par_id141559577104334">Note that currently all
named character class terms, [:alpha:] through [:upper:], must be enclosed in
parentheses when used in a regular expression, see the examples that
follow.</paragraph>
+<paragraph role="paragraph" id="par_id261559577375317">Regular expression
terms can be combined to form complex and sophisticated regular expressions for
searches as show in the following examples.</paragraph>
+<h2 id="hd_id5311441">Examples</h2>
+
+<table id="tab_id831559577400291">
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id901559577400292"
role="tablehead">Expression</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id381559577400292"
role="tablehead">Meaning</paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id641559577400292" role="tablecontent"
localize="false">^$</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id621559577542068" role="tablecontent">An
empty paragraph.</paragraph>
+ <paragraph id="par_id311559577563701"
role="tablecontent"><variable id="startpar">^ specifies that the match must be
at the start of a paragraph,</variable></paragraph>
+ <paragraph id="par_id391559577592658"
role="tablecontent"><variable id="endpar">$ specifies that a paragraph mark or
the end of a cell must follow the matched string.</variable></paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id251559577837101" role="tablecontent"
localize="false">^.</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id771559577837101" role="tablecontent">The
first character of a paragraph.</paragraph>
+ <paragraph role="tablecontent" id="par_id871559577915900"
localize="false"><embedvar href="text/shared/01/02100001.xhp#startpar"
markup="ignore"/> </paragraph>
+ <paragraph role="tablecontent" id="par_id171559577924884">.
specifies any single character.</paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id721559577961403" role="tablecontent"
localize="false">e([:digit:])?</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id471559577961403" role="tablecontent">Matches
"e" by itself or an "e" followed by one digit.</paragraph>
+ <paragraph role="tablecontent" id="par_id421559578050163">e
specifies the character "e",</paragraph>
+ <paragraph role="tablecontent"
id="par_id591559578054502"><variable id="digit">[:digit:] specifies any decimal
digit,</variable></paragraph>
+ <paragraph role="tablecontent" id="par_id341559578058972">?
specifies zero or one occurrences of [:digit:].</paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id191559578087559" role="tablecontent"
localize="false">^([:digit:])$</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id551559578087559" role="tablecontent" >Matches
a paragraph or cells containing exactly one digit.</paragraph>
+ <paragraph role="tablecontent" id="par_id721559578137006"
localize="false"><embedvar href="text/shared/01/02100001.xhp#startpar"
markup="ignore"/></paragraph>
+ <paragraph role="tablecontent" id="par_id941559578151564"
localize="false"><embedvar href="text/shared/01/02100001.xhp#digit"
markup="ignore"/></paragraph>
+ <paragraph role="tablecontent" id="par_id791559578157006"
localize="false"><embedvar href="text/shared/01/02100001.xhp#endpar"
markup="ignore"/></paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id651559578184372" role="tablecontent"
localize="false">^[:digit:]{3}$</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id771559578184372" role="tablecontent">Matches
a paragraph or cell containing only three digit numbers</paragraph>
+ <paragraph role="tablecontent" id="par_id631559578489930"
localize="false"><embedvar href="text/shared/01/02100001.xhp#startpar"
markup="ignore"/></paragraph>
+ <paragraph role="tablecontent" id="par_id551559578496775"
localize="false"><embedvar
href="text/shared/01/02100001.xhp#digit"/></paragraph>
+ <paragraph role="tablecontent" id="par_id401559578501329">{3}
specifies that [:digit:] must occur three times,</paragraph>
+ <paragraph role="tablecontent" id="par_id251559578508215"
localize="false"><embedvar href="text/shared/01/02100001.xhp#endpar"
markup="ignore"/></paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id131559578728924" role="tablecontent"
localize="false">\bconst(itu|ruc)tion\b</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id891559578728925" role="tablecontent">Matches
the words "constitution" and "construction" but not the word
"constitutional."</paragraph>
+ <paragraph role="tablecontent" id="par_id381559578787403">\b
specifies that the match must begin at a word boundary,</paragraph>
+ <paragraph role="tablecontent" id="par_id721559578792194">const
specifies the characters "const",</paragraph>
+ <paragraph role="tablecontent" id="par_id941559578797721">( starts
the group,</paragraph>
+ <paragraph role="tablecontent" id="par_id641559578802269">itu
specifies the characters "itu",</paragraph>
+ <paragraph role="tablecontent" id="par_id271559578807054">|
specifies the alternative,</paragraph>
+ <paragraph role="tablecontent" id="par_id801559578813944">ruc
specifies the characters "ruc",</paragraph>
+ <paragraph role="tablecontent" id="par_id421559578820595">) ends
the group,</paragraph>
+ <paragraph role="tablecontent" id="par_id621559578825464">tion
specifies the characters "tion",</paragraph>
+ <paragraph role="tablecontent" id="par_id91559578832058">/b
specifies that the match must end at a word boundary.</paragraph>
+ </tablecell>
+ </tablerow>
+</table>
+
+
<section id="relatedtopics">
<embed href="text/shared/01/02100000.xhp#02100000"/>
<switch select="appl">
_______________________________________________
Libreoffice-commits mailing list
libreoffice-comm...@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/libreoffice-commits
