McIDAS-X User's Guide
Version 2024.1

[Search Manual] [Table of Contents] [Go to Previous] [Go to Next]


TFIND

Searches the current text frame.


Formats

TFIND U "expression
TFIND UC "expression
TFIND D "expression
TFIND DC "expression
TFIND T


Parameters

U

searches upward in the text frame for the first match of the specified expression; the search is not case-sensitive; it matches uppercase, lowercase and mixed-case text

UC

searches upward in the text frame for the first match of the specified expression; the search is case-sensitive; it only displays text that exactly matches the expression

D

searches downward in the text frame for the first match of the specified expression; the search is not case-sensitive; it matches uppercase, lowercase or mixed-case text

DC

searches downward in the text frame for the first match of the specified expression; the search is case-sensitive; it only displays text that exactly matches the expression

T

displays the first line of the text frame

"expression

expression to find in the text frame; must be entirely uppercase if using the U or D option; can be uppercase, lowercase or mixed-case if using the UC or UD option (default=last specified expression)


Remarks

Each of the ten text frames (numbered 0-9) can contain thousands of lines of text. You can set the number of lines for each text frame by specifying the -oh flag at startup or in your .mcidasrc file.

The Text and Command Window displays text frames. You can only view one text frame at a time and only a few lines of text. The TFIND command displays the line that matches a specified expression at the bottom of the Text and Command Window.

The far right side of the status bar in the Text and Command Window displays the offset number if you are viewing a location other than the bottom of the text frame, which has an offset of zero. For example, if 5[14] appears below the T on the status bar, it indicates that the 14th line from the end of text frame 5 is displayed.

If you enter TFIND with no parameters, it repeats the previous TFIND command. Thus, you can run one TFIND command with the direction and expression specified, then continue searching for the same expression by entering TFIND as many times as needed. If you want to change the direction of the search without changing the expression, enter TFIND U or TFIND D. Use TFIND T to display the first line of text in the text frame. Press the Enter key to return to the bottom. You can also move up or down in the text frame using the up and down arrow keys and the Page Up and Page Down keys.


Examples

TFIND

Repeats the previous TFIND command.

TFIND U "DONE

This entry searches upward in the text frame for a line that contains the expression DONE. The expression can be any mix of uppercase and lowercase letters if the letters are in the correct order with no spaces between. If a match is found, that line is displayed at the bottom of the Text and Command Window.

TFIND D

If run after the previous example, this entry searches downward in the text frame for a line that contains the expression DONE. Like the previous example, the expression can be any mix of uppercase and lowercase letters if the letters are in the correct order with no spaces between. If a match is found, that line is displayed at the bottom of the Text and Command Window.

TFIND UC "abc DEF

This entry searches upward in the text frame for a line that contains the expression abc DEF. It must be an exact match, as the UC option is case-sensitive. There must be exactly one space between the c and the D since only one space was specified in the expression. If a match is found, that line is displayed at the bottom of the Text and Command Window.

TFIND T

This entry displays the top line of the text frame at the bottom of the Text and Command Window.


[Search Manual] [Table of Contents] [Go to Previous] [Go to Next]