TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools

Trace:
general:pattern_matching

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
general:pattern_matching [2017/09/22 19:25] – [Date Pattern Matching] dcumminggeneral: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 ===== ===== String Pattern Matching =====
  
-=== Asterisk (*) ===+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.
  
-The **Asterisk is used** to indicate which character positions are to be filtered. +100000L4, 100001L4, 100002L4, 100003L4, 100004L4, 100012L4, 100022L4, 200000L5, 200012L5, 200022L5
-{{image}} +
-  * An **Asterisk** before a set of characters will show all items that end with those characters. +
-  * An **Asterisk** after a set of characters will show all items that begin with those characters. +
-  * If used on its own, the **Asterisk** will display all data in that column. +
-  * 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.+
  
-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.png}}
  
-=== Question Mark (?) ===+ 
 +==== Asterisk (*) ==== 
 + 
 +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 [[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 [[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, 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 [[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}} 
 + 
 +==== Question Mark (?) ====
  
 The **Question Mark** is used to indicate that any character can exist in a specific character position. The **Question Mark** is used to indicate that any character can exist in a specific character position.
-{{image}} 
  
-=== Square Brackets ([ ]) ===+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}} 
 + 
 +==== Square Brackets ([ ]) ====
  
 **Square Brackets** can be used to provide parameters for a specific character position that are longer than one character. There are four different configurations: **Square Brackets** can be used to provide parameters for a specific character position that are longer than one character. There are four different configurations:
Line 30: Line 47:
  
 When multiple characters are put in a **Square Bracket**, any of the characters listed will be displayed at the specified character position. When multiple characters are put in a **Square Bracket**, any of the characters listed will be displayed at the specified character position.
-{{image}} 
  
 +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.
  
-=== Vertical Bar (|) ===+**Range Of Characters**
  
-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 [[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.
-{{image}}+
  
-=== Hyphen (-) ===+{{:general:filter_values_range.png}}
  
-When two characters are placed between **Square Brackets** and separated by a **Hyphen**, any character alphanumerically between the two characters will display. 
-{{image}} 
  
-=== Exclamation Point (!) ===+ 
 + 
 +==== Vertical Bar (|) ==== 
 + 
 +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 [[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}} 
 + 
 +==== Hyphen (-) ==== 
 + 
 +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 [[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}} 
 + 
 +==== Exclamation Point (!) ====
  
 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**. 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**.
-{{image}}+ 
 +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 58: Line 93:
 === Syntax === === 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 - x 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 === === Examples ===
  
-|*-10     | 10 days ago  | +^ Date Syntax ^ Description ^ 
-|Y        | the beginning of this year  | +|*-10     | Today - 10 days  | 
-|M-0-     | 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}}
  
general/pattern_matching.1506108329.txt.gz · Last modified: 2025/01/21 22:07 (external edit)