Differences

This shows you the differences between two versions of the page.

--- general:pattern_matching [2019/02/27 21:52] – Batch edit Volume ID to Volume-ID Phase 1 dcumming
+++ general:pattern_matching [2025/01/21 22:07] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-====== Pattern matching ======
+====== Pattern Matching And Filter Strings======
-TapeTrack has powerful pattern matching functionality that can be utilized globally in TapeMaster.
+TapeTrack has powerful pattern matching functionality that can be utilized globally in [[desktop:master|TapeMaster]].
+===== TapeMaster Quick Filters =====
+TapeMaster fields can be filtered by Repository, Flags, Next Move and/or Container by using the funnel buttons on the right of the filter fields.
+To use quick filters just click on the required column funnel and select the filter value.
+{{tapemaster_filters.png}}
@@ Line 7: / Line 15: @@
 ===== String Pattern Matching =====
-To illustrate the effects of where and how the asterisk wildcard affects search results all examples will be performed against the following volume values.
+To illustrate the effects of where and how the asterisk wildcard affects search results all examples will be performed against the following [[object:volume|Volume]] values.
 L4, 100001L4, 100002L4, 100003L4, 100004L4, 100012L4, 100022L4, 200000L5, 200012L5, 200022L5
@@ Line 16: / Line 24: @@
 ==== Asterisk (*) ====
-The **Asterisk is used** as a wildcard to allow string matching in multiple positions and variable string lengths.
+The **Asterisk is used** as a wildcard to allow String matching in multiple positions and variable String lengths.
-  * An **Asterisk** before a set of characters will show all items that end with those characters. \\ Using the filter *L4 in the Volume-ID field will show all Volume-ID's ending in L4.  \\ {{:general:filter_values_ast_value.png}} \\
+  * An **Asterisk** before a set of characters will show all items that end with those characters. \\ Using the filter ''*L4'' in the [[object:volume|Volume-ID]] field will show all [[object:volume|Volume-ID's]] ending in L4.  \\ {{:general:filter_values_ast_value.png}} \\ \\
-  * An **Asterisk** after a set of characters will show all items that begin with those characters. \\ Using the filter 20* in the Volume-ID field will display all Volume-ID's starting with 20. \\ {{:general:filter_values_value_ast.png}} \\
+  * An **Asterisk** after a set of characters will show all items that begin with those characters. \\ Using the filter ''20*'' in the [[object:volume|Volume-ID]] field will display all [[object:volume|Volume-ID's]] starting with 20. \\ {{:general:filter_values_value_ast.png}} \\ \\
-  * If used on its own, the **Asterisk** will match everything and will have no effect on volumes displayed.
+  * If used on its own, the **Asterisk** will match everything and, as such, will have no effect on [[object:volume|Volumes]] displayed.  \\ \\
-  * Using two **Asterisks**, one on either side of a character or set of characters will show all items containing that character or set of characters at any character position. \\ Using the filter *02* in the Volume-ID field will display all Volume-ID's that have 02 anywhere within the ID. \\ {{:general:filter_values_ast_value_ast.png}} \\
+  * Using two **Asterisks**, one on either side of a character or set of characters will show all items containing that character or set of characters at any character position. \\ Using the filter ''*02*'' in the [[object:volume|Volume-ID]] field will display all [[object:volume|Volume-ID's]] that have 02 anywhere within the ID. \\ {{:general:filter_values_ast_value_ast.png}} \\ \\
+  * The Asterisk does not need to be used when entering a full Object-ID or when searching for [[common:volume_flags|Flags]] in the [[master:view_volume_list|Volume List]]. \\ {{:general:filter_values_id_flag.png}}
-The Asterisk does not need to be used when entering a full Object-ID or when searching for [[common:volume_flags|Flags]] in the [[master:view_volume_list|Volume List]].
-{{:general:filter_values_id_flag.png}}
 ==== Question Mark (?) ====
@@ Line 31: / Line 36: @@
 The **Question Mark** is used to indicate that any character can exist in a specific character position.
-Using the filter ??????L4 in the Volume-ID field will display all eight character Volume-ID's ending in L4.
+Using the filter ''??????L4'' in the [[object:volume|Volume-ID]] field will display all eight character [[object:volume|Volume-ID's]] ending in L4.
 {{:general:filter_values_question.png}}
@@ Line 43: / Line 48: @@
 When multiple characters are put in a **Square Bracket**, any of the characters listed will be displayed at the specified character position.
-Using the filter, in the Volume-ID field, [12]?????L[45] will display all eight character Volume-ID's that start in either 1 or 2 and end in either L4 or L5.
+Using the filter, in the [[object:volume|Volume-ID]] field, ''[12]?????L[45]'' will display all eight character [[object:volume|Volume-ID's]] that start in either 1 or 2 and end in either L4 or L5.
 **Range Of Characters**
-Using the filter, in the Volume-ID field, [12]?????L[4-7] will display all eight character Volume-ID's that start in either 1 or 2 and end in either L4, L5, L6 or L7.
+Using the filter, in the [[object:volume|Volume-ID]] field, ''[12]?????L[4-7]'' will display all eight character [[object:volume|Volume-ID's]] that start in either 1 or 2 and end in either L4, L5, L6 or L7.
 {{:general:filter_values_range.png}}
@@ Line 58: / Line 63: @@
 When two or more characters are placed between **Square Brackets** and separated by **Vertical Bars**, the **Vertical Bar** will act as the word "OR" displaying any of the characters.
-Using the filter, in the Volume-ID field, ??????L[4|5] will display all eight character Volume-ID's that end in either L4 **OR** L5.
+Using the filter, in the [[object:volume|Volume-ID]] field, ''??????L[4|5]'' will display all eight character [[object:volume|Volume-ID's]] that end in either L4 **OR** L5.
 {{:general:filter_values_or.png}}
@@ Line 66: / Line 71: @@
 When two characters are placed between **Square Brackets** and separated by a **Hyphen**, any character alphanumerically between the two characters inclusive will display.
-Using the filter, in the Volume-ID field, ??????L[1-4] will display all eight character Volume-ID's that end in L1, L2, L3 OR L4.
+Using the filter, in the [[object:volume|Volume-ID]] field, ??????L[1-4] will display all eight character [[object:volume|Volume-ID's]] that end in L1, L2, L3 OR L4.
 {{:general:filter_values_range.png}}
@@ Line 74: / Line 79: @@
 When the **Exclamation Point** is placed immediately following the left **Square Bracket** in a set of **Square Brackets**, any character except for the characters listed after the **Exclamation Point** will display. This functionality also works with **Multiple Characters**, **Vertical Bars**, and **Hyphens**.
-Using the filter, in the Volume-ID field, ??????L!([1-4]) will display all eight character Volume-ID's that start end in anything other than 1, 2, 3 or 4.
+Using the filter, in the [[object:volume|Volume-ID]] field, ''??????L!([1-4])'' will display all eight character [[object:volume|Volume-ID's]] that start end in anything other than 1, 2, 3 or 4.
 {{:general:filter_values_not_range.png}}
@@ Line 88: / Line 93: @@
 === Syntax ===
-  * **YYYY-MM-DD:** ISO Date format
+^ Syntax      ^ Description                                                                                                                       ^
-  * ***:** Today
+| YYYY-MM-DD  | ISO Date Format                                                                                                                   |
-  * ***[+-]x:** Today + or - x days
+| *           | Today                                                                                                                             |
-  * **M:** The first day of this month
+| W           | This Week                                                                                                                         |
-  * **m:** The last day of this month
+| P           | The oldest Date                                                                                                                   |
-  * **Y:** The first day of the year
+| F           | The most Future Date                                                                                                              |
-  * **y:** The last day of the year
+| *±x         | Today ± number of days (x).                                                                                           |
-  * **M+-x:** The first day of the month + or - x months
+| M           | The first day of this month                                                                                                       |
-  * **M+-x+-y:** The first day of the month + or - x months + or - y days
+| m           | The last day of this month.                                                                                                       |
-  * **Y+-x:** The first day of the year + or - x months
+| Y           | The first day of the year.                                                                                                        |
-  * **Y+-x+-y:** The first day of the year + or - x years + or - y months
+| y           | The last day of the year.                                                                                                         |
-  * **Y+-x+-y+-z:** The first day of the year + or - x years + or - y months + or - z days
+| M±x         | The first day of the month ± number of months (x).                                                                    |
+| M±x±y       | The first day of the month ± number of months (x), ± number of days (y).                                  |
+| Y±x         | The first day of the year ± x number of years                                                                         |
+| Y±x±y       | The first day of the year ± number of years (x) ± number of months (y).                                   |
+| Y±x±y±z     | The first day of the year ± number of years (x) ± number of months (y) ± number of days (z).  |
 === Examples ===
-|*-10     | 10 days ago  |
+^ Date Syntax ^ Description ^
-|Y        | the beginning of this year  |
+|*-10     | Today - 10 days  |
-|M-1      | the last day of last month  |
+| W-10    | 10 Weeks ago |
-|y-1      | the last day of last year  |
+| W+2     | 2 Weeks in the future |
-|Y-1+3-1  | the last day of February last year  |
+| M       | The first day of this month |
+| M-1     | The first day of last month  |
+|Y        | The beginning of this year  |
+|y-1      | The last day of last year  |
+|Y-1+3-1  | The last day of February last year  |
+| P       | The oldest date |
+| P+50    | The oldest date plus 50 days |
+| F       | The most future date |
+^ Date Range Syntax ^ Description ^
+| *-10:* | 10 days ago until today |
+| W-2:* | Two weeks ago until today |
+| M-4:W+2 | First day of four months ago until two weeks from today |
+=== Pattern Matching ===
+^ Syntax ^ Description ^
+| ???? | 4 Character long |
+| ????* | 4 or more long |
+| !(?*) | Empty string,  not 1 character or more
+{{tag> date technote tapemaster lite cli}}