._softset - macmcmeans/localDataStorage GitHub Wiki

localDataStorage._softset( keyName, value )

This Memory Key method stores value under keyName, creating a new key if necessary, but cannot overwrite an existing value. In other words, this can only create a new key, and will ignore all existing keys having keyName. This method is useful when the requirement involves preserving 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 corresponding disk-based method is softset.