Clover icon

Coverage Report

  1. Project Clover database Thu Aug 13 2020 12:04:21 BST
  2. Package jalview.api

File FinderI.java

 

Code metrics

0
0
0
1
82
12
0
-
-
0
-

Classes

Class Line # Actions
FinderI 31 0 0
-1.0 -
 

Contributing tests

No tests hitting this source file were found.

Source view

1    /*
2    * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
3    * Copyright (C) $$Year-Rel$$ The Jalview Authors
4    *
5    * This file is part of Jalview.
6    *
7    * Jalview is free software: you can redistribute it and/or
8    * modify it under the terms of the GNU General Public License
9    * as published by the Free Software Foundation, either version 3
10    * of the License, or (at your option) any later version.
11    *
12    * Jalview is distributed in the hope that it will be useful, but
13    * WITHOUT ANY WARRANTY; without even the implied warranty
14    * of MERCHANTABILITY or FITNESS FOR A PARTICULAR
15    * PURPOSE. See the GNU General Public License for more details.
16    *
17    * You should have received a copy of the GNU General Public License
18    * along with Jalview. If not, see <http://www.gnu.org/licenses/>.
19    * The Jalview Authors are detailed in the 'AUTHORS' file.
20    */
21    package jalview.api;
22   
23    import jalview.datamodel.SearchResultsI;
24    import jalview.datamodel.SequenceI;
25   
26    import java.util.List;
27   
28    /**
29    * An interface for searching for a pattern in an aligment
30    */
 
31    public interface FinderI
32    {
33   
34    /**
35    * Performs a find for the given search string (interpreted as a regular
36    * expression). Search may optionally be case-sensitive, and may optionally
37    * including match in sequence description (sequence id is always searched).
38    * If the viewport has an active selection, then the find is restricted to the
39    * selection region. Sequences matched by id or description can be retrieved
40    * by getIdMatches(), and matched residue patterns by getSearchResults().
41    *
42    * @param theSearchString
43    * @param caseSensitive
44    * @param searchDescription
45    * @return
46    */
47    void findAll(String theSearchString, boolean caseSensitive,
48    boolean searchDescription);
49   
50    /**
51    * Finds the next match for the given search string (interpreted as a regular
52    * expression), starting from the position after the last match found. Search
53    * may optionally be case-sensitive, and may optionally including match in
54    * sequence description (sequence id is always searched). If the viewport has
55    * an active selection, then the find is restricted to the selection region.
56    * Sequences matched by id or description can be retrieved by getIdMatches(),
57    * and matched residue patterns by getSearchResults().
58    *
59    * @param theSearchString
60    * @param caseSensitive
61    * @param searchDescription
62    * @return
63    */
64    void findNext(String theSearchString, boolean caseSensitive,
65    boolean searchDescription);
66   
67    /**
68    * Returns the (possibly empty) list of sequences matched on sequence name or
69    * description
70    *
71    * @return
72    */
73    List<SequenceI> getIdMatches();
74   
75    /**
76    * Answers the search results (possibly empty) from the last search
77    *
78    * @return
79    */
80    SearchResultsI getSearchResults();
81   
82    }