Action: Savevalue(name, value)

Related Actions: valuepool, loadvalue, deletevalue
See also: FKiSS, Value Pools, Events, Actions

savevalue(name, value)

First defined in: FKiSS4
The savevalue action saves a value to disk which can be loaded again later, even during future sessions.
For more information, see Value Pools.

name

name is an identifier under which the value will be stored. It may be between 1 and 64 characters. They may contain letters, digits, hyphens, and underscores. Value names are case-insensitive. The name must be enclosed with quotation marks.
If you want to specify a valuepool other than the current pool without changing the current pool, you can specify it in the value name by separating it with a period (.).

name

value may be either a variable or a number.
The value will be stored in the current pool as specified by the most recent valuepool command.

Example:

;@ savevalue("HighScore", score)               ; stores value in score under "HighScore" in the current value pool.
;@ savevalue("Johns_Adventure1.strength", str) ; stores value in str under "strength" in the value pool "Johns_Adventure1".
;@ savevalue(".SnapTo", snap)                  ; stores value in snap under "SnapTo" in the private value pool for this KiSS data set.