.rename

localDataStorage.rename( existingKey, newKey )

This method assigns the value of existingKey to newKey, where the key prefix is prepended to newKey. The existingKey is deleted. Data types are preserved, so if a Float was set then a Float will be returned.

If newKey already exists, an error will be thrown because existing keys cannot be overwritten.

EXAMPLES:

● localData.rename( 'key1', 'key1-1000' )

NOTE: There is nothing to prevent you, inadvertently or otherwise, from renaming an obfuscated key (created using safeset). Once renamed, it will be impossible to retrieve the original protected value as the keyname itself is used to create the obfuscation.

An event is fired from this method allowing you to monitor the key name change.