Tools: MPW
Advanced Search
Apple Developer Connection
Member Login Log In | Not a Member? Support

MPW Command Reference


Clear

Built-in

SYNTAX

Clear selectionExpression [window] [-c count]

DESCRIPTION

The Clear command deletes the text matched by selectionExpression in the specified window. Note that the MPW Shell does not copy the text to the Clipboard.

INPUT

None

OUTPUT

None

ALIAS RESOLUTION

A partial pathname or a pathname containing Finder aliases may be substituted for the window name as long as the pathname specifies the name of an open window. Note that using a shell variable to designate a window is usually faster than requiring MPW to resolve a Finder alias.

STATUS

Clear can return the following status codes:

0

at least one instance of selectionExpression found

1

syntax error

2

other errors

PARAMETERS

selectionExpression

Specifies the lines of text to be deleted.

window

Specifies the window in which Clear finds the selection. If you do not specify a window, the command defaults to the target window. Specifying a window that does not exist results in an error message.

OPTIONS

-c count

Deletes up to count instances of the selection. By default, Clear assumes the count is 1. Use the infinity symbol (∞) to delete all instances of the selection.

EXAMPLES

The following command line deletes the current selection (§). This resembles the Clear menu item in the Edit menu, except that the action occurs in the target window rather than in the active window.

Clear §

Executing the following command line causes Clear to delete everything from the next Begin through the following End:

Clear /Begin/:/End/

SEE ALSO

Cut

Replace

 
 


Last Updated July 2000