QueryStrings » History » Version 3
Dan Smith, 12/11/2024 09:06 AM
1 | 3 | Dan Smith | # Query filter strings |
---|---|---|---|
2 | 1 | Dan Smith | CHIRP supports filtering the memory view according to a query string. This can be used to temporarily limit the memories being displayed to make it easier to find things. |
3 | |||
4 | <img src="clipboard-202412110848-ii0m9.png" width=800/> |
||
5 | |||
6 | If you type a simple string (without spaces or special characters) CHIRP will search the frequency, name, and comment fields for that string. However, if you use a specific query language, more complex filtering is possible. |
||
7 | |||
8 | |Operation |Example |Result | |
||
9 | |-----------------------------|-------------------------------|------------------------------------------------------------| |
||
10 | | Find name containing string | `name~"mountain"` | Display memories with "mountain" in the name | |
||
11 | | Find exact name | `name="KK7DS"` | Display memories with name exactly matching "KK7DS" | |
||
12 | | Find specific frequency | `freq=146.52` | Display memories with frequency of 146.52MHz | |
||
13 | | Find range of frequencies | `freq<144,148>` | Display memories with frequency between 144-148MHz | |
||
14 | | Find only D-STAR memories | `mode="DV"` | Display memories that have "DV" in the mode column | |
||
15 | | Find only airband memories | `mode="AM" and freq<118,134>` | Display memories that are AM and between 118-134MHz | |
||
16 | 2 | Dan Smith | |
17 | ## Exact match |
||
18 | |||
19 | Using the `=` operator, you can match a specific field to an exact value. For fields like `name`, `comment`, `tmode`, etc this will be a quoted string (i.e. `"foo"`). For `freq`, `rtone`, `ctone`, etc, this will be a number (either floating-point or integer). |
||
20 | |||
21 | ## Regex Match |
||
22 | |||
23 | Using the `~` operator, you can match a specific field to a regular expression (as a quoted string). This only works on string fields like `name`, `comment`, etc. |
||
24 | |||
25 | ## Range |
||
26 | |||
27 | Using the syntax `<LO,HI>` you can search numerical fields for being within a range. This works for things like `freq` and `rtone`, etc. |
||
28 | |||
29 | ## Multiple expressions |
||
30 | |||
31 | Boolean operators `AND` and `OR` are allowed, as well as using parenthesis around a sub-expression. |