._rename - macmcmeans/localDataStorage GitHub Wiki

localDataStorage._rename( existingKey, newKey )

This Memory Key method assigns the value of existingKey to newKey and subsequently deletes existingKey from the store. 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.

EXAMPLE:

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

🛢 The corresponding disk-based method is rename.