.set - macmcmeans/localDataStorage GitHub Wiki

localDataStorage.set( keyName, value )

This method stores value under keyName, creating a new key if necessary, where the key prefix is prepended to keyName. Data types are preserved, so if a Float was set then a Float will be returned. If data obfuscation is desired, use safeset.

This will overwrite an existing value for keyName. If this happens, the prior value cannot be retrieved.

The value of the updated key is returned when this method executes.

EXAMPLES:

● localData.set( 'key1', 'Belgian' ) ● localData.set( 'key2', 1200.0047 ) ● localData.set( 'key3', true ) ● localData.set( 'key4', { 'RSK' : [1,3,5,7,9] } ) ● localData.set( 'key5', null )

🌐 This method may fire an event allowing you to monitor the key change.

✨ The complement to this is get.

🏿 The corresponding Memory Key method is _set.

📝 NOTE: Keys stored by this method can also be retrieved using forceget, at the loss of the data type.