String filter and state. More...
#include <stringfilter_type.h>
Data Structures | |
| struct | WordState |
| State of a single filter word. More... | |
Public Member Functions | |
| StringFilter (const bool *case_sensitive=nullptr, bool locale_aware=true) | |
| Constructor for filter. More... | |
| void | SetFilterTerm (const char *str) |
| Set the term to filter on. More... | |
| void | SetFilterTerm (const std::string &str) |
| Set the term to filter on. More... | |
| bool | IsEmpty () const |
| Check whether any filter words were entered. More... | |
| void | ResetState () |
| Reset the matching state to process a new item. | |
| void | AddLine (const char *str) |
| Pass another text line from the current item to the filter. More... | |
| void | AddLine (const std::string &str) |
| Pass another text line from the current item to the filter. More... | |
| void | AddLine (StringID str) |
| Pass another text line from the current item to the filter. More... | |
| bool | GetState () const |
| Get the matching state of the current item. More... | |
Private Attributes | |
| const char * | filter_buffer |
| Parsed filter string. Words separated by 0. | |
| std::vector< WordState > | word_index |
| Word index and filter state. | |
| uint | word_matches |
| Summary of filter state: Number of words matched. | |
| const bool * | case_sensitive |
| Match case-sensitively (usually a static variable). | |
| bool | locale_aware |
| Match words using the current locale. | |
Detailed Description
String filter and state.
The filter takes a stringterm and parses it into words separated by whitespace. The whitespace-separation can be avoided by quoting words in the searchterm using " or '. The quotation characters can be nested or concatenated in a unix-shell style.
When filtering an item, all words are checked for matches, and the filter matches if every word matched. So, effectively this is a AND search for all entered words.
Once the filter is set up using SetFilterTerm, multiple items can be filtered consecutively.
- For every item first call ResetState() which resets the matching-state.
- Pass all lines of the item via AddLine() to the filter.
- Check the matching-result for the item via GetState().
Definition at line 30 of file stringfilter_type.h.
Constructor & Destructor Documentation
◆ StringFilter()
|
inline |
Constructor for filter.
- Parameters
-
case_sensitive Pointer to a (usually static) variable controlling the case-sensitivity. nullptr means always case-insensitive.
Definition at line 50 of file stringfilter_type.h.
Member Function Documentation
◆ AddLine() [1/3]
| void StringFilter::AddLine | ( | const char * | str | ) |
Pass another text line from the current item to the filter.
You can call this multiple times for a single item, if the filter shall apply to multiple things. Before processing the next item you have to call ResetState().
- Parameters
-
str Another line from the item.
Definition at line 114 of file stringfilter.cpp.
References case_sensitive, locale_aware, StrNaturalContains(), StrNaturalContainsIgnoreCase(), word_index, and word_matches.
Referenced by AddLine(), IndustryDirectoryWindow::BuildSortIndustriesList(), ClassTagNameFilter(), BuildVehicleWindow::FilterByText(), ScriptDebugWindow::OnInvalidateData(), SignList::SignNameFilter(), NetworkContentListWindow::TagNameFilter(), NewGRFWindow::TagNameFilter(), TypeTagNameFilter(), SettingEntry::UpdateFilterState(), and SettingsPage::UpdateFilterState().
◆ AddLine() [2/3]
| void StringFilter::AddLine | ( | const std::string & | str | ) |
Pass another text line from the current item to the filter.
You can call this multiple times for a single item, if the filter shall apply to multiple things. Before processing the next item you have to call ResetState().
- Parameters
-
str Another line from the item.
Definition at line 144 of file stringfilter.cpp.
References AddLine().
◆ AddLine() [3/3]
| void StringFilter::AddLine | ( | StringID | str | ) |
Pass another text line from the current item to the filter.
You can call this multiple times for a single item, if the filter shall apply to multiple things. Before processing the next item you have to call ResetState().
- Parameters
-
str Another line from the item.
Definition at line 157 of file stringfilter.cpp.
References AddLine(), and GetString().
◆ GetState()
|
inline |
Get the matching state of the current item.
- Returns
- true if matched.
Definition at line 71 of file stringfilter_type.h.
Referenced by IndustryDirectoryWindow::BuildSortIndustriesList(), ClassTagNameFilter(), BuildVehicleWindow::FilterByText(), ScriptDebugWindow::OnInvalidateData(), SignList::SignNameFilter(), NetworkContentListWindow::TagNameFilter(), NewGRFWindow::TagNameFilter(), TypeTagNameFilter(), SettingEntry::UpdateFilterState(), and SettingsPage::UpdateFilterState().
◆ IsEmpty()
|
inline |
Check whether any filter words were entered.
- Returns
- true if no words were entered.
Definition at line 60 of file stringfilter_type.h.
Referenced by IndustryDirectoryWindow::BuildSortIndustriesList(), BuildVehicleWindow::FilterByText(), NetworkContentListWindow::FilterContentList(), SignListWindow::OnInvalidateData(), NetworkContentListWindow::OnInvalidateData(), GameSettingsWindow::OnInvalidateData(), NetworkContentListWindow::UpdateFilterState(), SettingEntry::UpdateFilterState(), and SettingsPage::UpdateFilterState().
◆ SetFilterTerm() [1/2]
| void StringFilter::SetFilterTerm | ( | const char * | str | ) |
Set the term to filter on.
- Parameters
-
str Filter term
Definition at line 28 of file stringfilter.cpp.
References filter_buffer, free(), word_index, and word_matches.
Referenced by ScriptDebugWindow::ScriptDebugWindow(), SignListWindow::SetFilterString(), and SetFilterTerm().
◆ SetFilterTerm() [2/2]
| void StringFilter::SetFilterTerm | ( | const std::string & | str | ) |
Set the term to filter on.
- Parameters
-
str Filter term
Definition at line 90 of file stringfilter.cpp.
References SetFilterTerm().
The documentation for this struct was generated from the following files:
- src/stringfilter_type.h
- src/stringfilter.cpp
