- Cisco Active Network Abstraction Customization User Guide, 3.6.4
Table Of Contents
Parsing Operators/Rules
This chapter describes the predefined text manipulation operators available for parsing raw device input and turning each into a soft property that is available in the Add/Edit Parsing Rule dialog box. The chapter includes the name, description, expected input, validation rules, and any unique fields displayed in the dialog box for each operator and provides an example, as well.
This chapter includes the following sections:
•
Set
For more information about the Add/Edit Parsing Rule dialog box, see Defining the Parsing Parameters, page 3-9.
Header and Footer
Description
Removes a specified number of lines from the header and footer of the input text.
Dialog Box
Figure 5-1 shows the Add/Edit Parsing Rule dialog box that is displayed when the Header And Footer operator is selected. In addition, the dialog box displays an example using the Header And Footer operator.
Figure 5-1 Header and Footer Operator
Parameters
Header lines
The number of header lines to be removed.
Integers only. Mandatory.
Footer lines
The number of footer lines to be removed.
Integers only. Mandatory.
Remove Lines
Description
Removes a range of lines from the specified starting row to the specified end row of the input text.
Dialog Box
Figure 5-2 shows the Add/Edit Parsing Rule dialog box that is displayed when the Remove Lines operator is selected. In addition, the dialog box displays an example using the Remove Lines operator.
Figure 5-2 Remove Lines Operator
Parameters
Select Lines
Description
Extracts a range of lines from the specified starting row to the specified end row of the input text.
Dialog Box
Figure 5-3 shows the Add/Edit Parsing Rule dialog box that is displayed when the Select Lines operator is selected. In addition, the dialog box displays an example using the Select Lines operator.
Figure 5-3 Select Lines Operator
Parameters
Replace
Description
Finds one substring or all occurrences of a substring that matches a specified regular expression, and replaces it with a specified value.
Dialog Box
Figure 5-4 shows the Add/Edit Parsing Rule dialog box that is displayed when the Replace operator is selected. In addition, the dialog box displays an example using the Replace operator.
Figure 5-4 Replace Operator
Parameters
Match
Description
Finds and extracts a substring that matches a specified regular expression. If no match can be found, the output buffer receives an empty string.
Dialog Box
Figure 5-5 shows the Add/Edit Parsing Rule dialog box that is displayed when the Match operator is selected. In addition, the dialog box displays an example using the Match operator.
Figure 5-5 Match Operator
Parameters
Expression
Search for value or regular expression.
Text. Mandatory.
Set
Description
Prints the results of the input and output buffers.
Dialog Box
Figure 5-6 shows the Add/Edit Parsing Rule dialog box that is displayed when the Set operator is selected. In addition, the dialog box displays an example using the Set operator.
Figure 5-6 Set Operator
Parameters
Expression
Regular expression template to use for formatting. $_$ specifies the main output buffer.
Text. Mandatory.
Substring
Description
Extracts a substring of a specified length from a specified starting point.
Dialog Box
Figure 5-7 shows the Add/Edit Parsing Rule dialog box that is displayed when the Substring operator is selected. In addition, the dialog box displays an example using the Substring operator.
Figure 5-7 Substring Operator
Parameters
Parse Integer
Description
Uses the substring rule, and when a result is received with the substring it is converted into an integer value.
Note
Dialog Box
Figure 5-8 shows the Add/Edit Parsing Rule dialog box that is displayed when the Parse Integer operator is selected. In addition, the dialog box displays an example using the Parse Integer operator.
Figure 5-8 Parse Integer Operator
Parameters
