2003 TextMaestro Technologies
10. Text Conversion Attributes
When you click on Text Conversion button from Main toolbar to open the Interactive Text Conversion dialog, a secondary dialog appears as shown below:
The technical aspect of Attributes needs some detailed discussions. Key concept of text conversion feature of TextMaestro spans over this section, Conversion Schemes and libraries, Batch Conversion, Quick Convert Help and a series of Examples. It is strongly recommended that you read these related topics to understand the heart of the matter.
Recall, above Attributes work in conjunction with the Interactive Text Conversion Window.
There are various rules and qualifiers involving wild-card usage. See Quick Convert Help to get started. See Example 14 for a demo on wild-card usage.
Here user can define his own set of type-cards. In gist, wild-card denotes "anything", and type-card denotes one or more of the character set assigned to it. What you see above is the default setting. Every Find and Replace library has its own Wild-Card Manager, thereby, its own set of type-cards. Type cards are extremely useful when you want to parse various log files where you want to identify a certain sequence of characters as a set, and then grab them by the corresponding type-card during parsing.
If you click on hyperlink Knobs..., this dialog will appear.
If you click on the hyper-links on the right side, marked by , , and , corresponding Quick Convert Help slides will appear.
Below is the description of the four knobs.
Per-line search: This works in conjunction with Use wild-card for Find. When the parsing builds a wild-card argument, the search might span over multiple lines. If this control is checked, the search is forced to discontinue when a line break is encountered inside a constructed wild-card argument, and continue for a new search from the current position. This is useful when you want to force the wild-card construction remain within a line.
Compact construct: This works in conjunction with Use wild-card for Find. Use this to advance search handle to determine if there can be a match within a match in order to make Find of minimal span. This is useful when you want to grab a block of text.
Filter processed text: This works in conjunction with Use wild-card for Find. Use this when you want to keep only the found and replaced text and discard everything else. This is useful when you are interested in certain type of text blocks in a large dump or source code. For example, class*}; for Find and class*}; for Replace, and having Filter processed text checked will display all class declarations from a set of .h files (with some set up under Batch Conversion).
Grabs all class declarations.
Delimiter parse: This works in conjunction with Use wild-card for Find. Use this when you want to grab a block of text delimited by a pair of delimiters listed in the Delimiter List, accessed by the button found next to the Delimiter parse check box. In such case, if Find string is found in a block of text, identified by the delimiter, then Replace string is used to replace the whole text block (not only the Find string.) Details are available in 12.b. Conversion Rules - Find And Replace | Knobs | Delimiter parse.