.softset - macmcmeans/localDataStorage GitHub Wiki

localDataStorage.softset( keyName, value )

This method stores value under keyName, creating a new key if necessary, but does not overwrite an existing value. In other words, this can only create a new (unobfuscated) key, and will ignore all existing keys having keyName.

This method is useful when the requirement involves preventing an existing key from being overwritten without having to test for existence (for example, calling haskey) prior to changing values.

EXAMPLES:

● localData.set( 'key2', 1200.0047 ) ● localData.softset( 'key2', 'test' ) ● localData.get( 'key2' )   -->   1200.0047

The value of keyName is returned when this method executes.

🌐 This method may fire an event allowing you to monitor a new key.

🏿 The corresponding Memory Key method is _softset.