c

Syntax	<ctrl>+c
Category	Update processor
Type	Command
Description	moves or copies data from one place to another. The data may reside in the current item being edited, or another item in the current file, or an item in a different file. Text can be cut and deleted or cut with the original left in place (copied). After the text is cut, it is placed in the "cut buffer", replacing the previous contents of the cut buffer. The text in the cut buffer can be pasted into the current item or it can be pasted into a specified item in another file. Marking the beginning cut location: There are two ways to mark the beginning position of text to cut. In both commands, the beginning cut position is determined by the position of the cursor when the command is issued. 1) "<ctrl>+cl" marks the beginning position of text to cut and specifies that the text is to be left in place (copied, not moved). 2) "<ctrl>+cd" marks the beginning position of text to cut and specifies that the text is to be deleted (moved) from its current location after it is cut. UP marks the beginning of the cut with a backslash ("\") on the terminal. "<ctrl>+zz" cancels the beginning cut mark. Marking the ending cut location: "<ctrl>+cc" marks the ending position of the cut. The ending cut position is determined by the position of the cursor when the command "<ctrl>+cc" is issued. Once the ending position has been marked (UP does not display any character for the end mark.), the marked text is placed in the cut buffer. As of release 6.1, the entire contents of a value can be saved into the cut buffer with one command. To store the internal contents (the value stored in the item), <ctrl>+ci can be used. To store the external contents (the value displayed on the screen), use <ctrl>+co. Saving the cut buffer: The "<ctrl>+cw" command writes the contents of the cut buffer to the item specified. "<ctrl>+cw" causes the Update processor to prompt with: cut save-id: This prompt appears at the top left corner of the terminal. Enter either an "item-id" or a "file.reference" and "item-id". If only an "item-id" is entered, the cut buffer contents are saved in the current file. If the file already has an item with the specified "item-id", the following prompt displays at the top left corner of the screen : 'cut.id' item exists on file, press "y" to overwrite: If any key other than "y" is typed, the cut text is NOT saved. If "y" is typed, the item that was on file is overwritten with the cut item. If the response to the prompt for cut save-id is a "file.reference" and "item-id", the item is written to the designated file with the specified "item-id". A left parenthesis character is required immediately before the "file.reference" and indicates that a different file is being specified. Pasting from an existing item: The "<ctrl>+cr" command reads the contents of the specified item and pastes the contents at the current cursor location. After "<ctrl>+cr" is entered, the terminal prompts with: paste from: Any valid "file.reference" and "item-id" are allowed in response to this prompt. When using UP as a text editor, a range of attribute numbers (separated by a space) may be specified after the "item-id". If the beginning and ending attribute numbers are omitted, the entire item is copied into the item being updated at the current cursor location. When in data entry mode, with dictionaries defining the attributes, "<ctrl>+cr" has two actions, depending on the status of the item being updated. In both cases, the range is omitted. 1) If the item being updated is new and if the cursor is on the first attribute in the item, "<ctrl>+cr" merges the entire item from the source item specified. 2) In all other cases, when "<ctrl>+cr" is entered, the corresponding (same attribute position) attribute is merged into the current item from the source item specified. Pasting cut at cursor location: "<ctrl>+cp" inserts the contents of the cut buffer, beginning at the current cursor position.
Options
See Also	item-id file.reference cut paste UP Commands delete text Update processor cl cd cc cp cw cr zd ze zg zn zo l o e Update processor (UP) ci co Update processor
Example
Warnings	The cut buffer remains intact until the UPdate processor is exited or another cut is performed. The cut buffer is NOT passed between levels. The cut buffer has a limit in size of 32k.
Compatibility	D3 7.0 AP

Index Level