9
<holder>Ericsson AB, All Rights Reserved</holder>
7
<year>1996</year><year>2010</year>
8
<holder>Ericsson AB. All Rights Reserved.</holder>
12
The contents of this file are subject to the Erlang Public License,
13
Version 1.1, (the "License"); you may not use this file except in
14
compliance with the License. You should have received a copy of the
15
Erlang Public License along with this software. If not, it can be
16
retrieved online at http://www.erlang.org/.
18
Software distributed under the License is distributed on an "AS IS"
19
basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
20
the License for the specific language governing rights and limitations
23
The Initial Developer of the Original Code is Ericsson AB.
11
The contents of this file are subject to the Erlang Public License,
12
Version 1.1, (the "License"); you may not use this file except in
13
compliance with the License. You should have received a copy of the
14
Erlang Public License along with this software. If not, it can be
15
retrieved online at http://www.erlang.org/.
17
Software distributed under the License is distributed on an "AS IS"
18
basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
19
the License for the specific language governing rights and limitations
44
<name>filter(Filters)</name>
45
<name>filter(Filters, Dates)</name>
46
<fsummary>Filter reports and displays them on the screen</fsummary>
48
<v>Filters = [filter()]</v>
49
<v>filter() = {Key, Value} | {Key, Value, no} | {Key, RegExp, re} | {Key, RegExp, re, no}</v>
52
<v>RegExp = string() | {string, Options} | mp(), {mp(), Options}</v>
53
<v>Dates = {DateFrom, DateTo} | {DateFrom, from} | {DateTo, to}</v>
54
<v>DateFrom = DateTo = {date(), time()}</v>
55
<v>date() and time() are the same type as in the <c>calendar</c> module</v>
58
<p>This function displays the reports that match the provided filters.</p>
60
When a filter includes the <c>no</c> atom it will exclude the reports that match
64
The reports are matched using the <c>proplists</c> module. The report must be a proplist
65
to be matched against any of the <c>filters()</c>.
68
If the filter is of the form <c>{Key, RegExp, re}</c> the report must contain an element with
69
<c>key = Key</c> and <c>Value</c> must match the RegExp regular expression.
72
If the Dates parameter is provided, then the reports are filtered according to the date
73
when they occurred. If Dates is of the form <c>{DateFrom, from}</c> then reports that occurred
74
after DateFrom are displayed.
77
If Dates is of the form <c>{DateTo, to}</c> then reports that occurred before DateTo
81
If two Dates are provided, then reports that occurred between those dates are returned.
84
If you only want to filter only by dates, then you can provide the empty list as the Filters
88
See <c>rb:grep/1</c> for more information on the RegExp parameter.
46
93
<name>grep(RegExp)</name>
47
94
<fsummary>Search the reports for a regular expression</fsummary>
49
<v>RegExp = string()</v>
96
<v>RegExp = string() | {string, Options} | mp(), {mp(), Options}</v>
52
99
<p>All reports containing the regular expression <c>RegExp</c>
55
<p><c>RegExp</c> is a string containing the regular
56
expression. Refer to the module <c>regexp</c> in the STDLIB
58
for a definition of valid regular expressions. They are
59
essentially the same as the UNIX command <c>egrep</c>.
102
<p><c>RegExp</c> can be a string containing the regular
103
expression; a tuple with the string and the options for
104
compilation; a compiled regular expression; a compiled
105
regular expression and the options for running it.
106
Refer to the module <c>re</c> and specially the function <c>re:run/3</c>
107
for a definition of valid regular expressions and options.