Overridden to return a change token for a specific save operation.
- iOS 5.0+
A constant that indicates whether the save operation is writing a new file or overwriting an existing one. See
UIDocumentfor descriptions of these constants.
An object to use as a change-count token.
To get autosaving capabilities for your documents, you must implement change tracking. Typically you do this by using an
Undo object (assigned to
undo property) to register changes or by calling the
update method every time the user makes a change; UIKit then automatically determines whether there are unsaved changes and returns the proper value from
has. If you take neither of these approaches (and you want the autosaving feature), you must implement this method as well as
You implement this particular method to return a change-count token that UIKit uses to encapsulate the history of document changes for a particular save operation. The token can be any object that represents the current change state of the document. This method is called at the start of the default implementation of the
save(to: method. At the end of this default implementation, it calls the
update method, passing in the change-count token. You implement the latter method to compare the token with the one returned earlier; by doing so, you can determine if the document has acquired new unsaved changes between the start and end of an asynchronous write operation. You can then return the proper value from your override of