SYNTAX

Cut selectionExpression [window] [-c count]

DESCRIPTION

The Cut command finds the text matched by selectionExpression in the specified window, copies its contents to the Clipboard, and then deletes it from the window.

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

Cut can return the following status codes:

PARAMETERS

selectionExpression

Specifies the text to be cut.

window

Specifies the window in which the text can be found. If you omit the window parameter, Cut uses the target window.

OPTIONS

-c count

Cuts up to count instances of the text matched by the selection expression. Normally Cut assumes that count is 1. You can use the infinity symbol (∞) to cut all instances of the selection.

Caution
Only the last instance of the selection remains in the Clipboard. •

EXAMPLES

The following command line cuts the first occurrence of the word "Paste" in the Test window. This action deletes "Paste" from the text and copies it to the Clipboard.

Cut /Paste/ Test

The following command line cuts the current selection in the target window. This is the same as the Cut menu item, except that it operates on the target window rather than on the active window.

Cut §

The command line below selects everything from the next Begin through the following End, copies the contents of the selection to the Clipboard, and then deletes the selected text.

Cut /Begin/:/End/

SEE ALSO

Clear

Copy

Paste