Sets the number of changes made to the file.
Scope: File
Syntax
query changes
set changes [Number]
Option
Number |
The new count of changes made to the file until the next save. The default is zero. |
Description
The changes parameter counts the number of changes made to the file until it is saved.
The changes count is increased by one every time a command that changes the file is issued or a line or part line is altered by overtyping. A macro that makes many alterations counts as just one change.
The changes count is also affected by the undo command. Each set of changes undone by an undo operation decrements the count by one, and each set of changes redone by a redo operations increases the count by one. If you perform undo operations to a document past a file save point, the changes count decrements until it reaches zero, after which it starts incrementing. The opposite occurs if you are redoing changes to a document.
When the file is saved, Number is set to zero.
Setting the changes parameter explicitly also adds Number to the value of the autochanges parameter. This means that the changes can be used to force an autosave operation. Changing the autochanges parameter does not change the changes parameter.
Examples
query changes
set changes 15
API Return Codes
-2 |
The number specified was either outside the valid range or not a whole number. Issue the command again using a valid number. |
![]()
autochanges Parameter
autocount Parameter
undo Command
