delete permanent()

Deletes the permanent value with name a under context b that has been saved using function "save permanent()".

The return value of the function is the deleted permanent value or an empty string with set Empty Flag if nothing was found.

Parameters


Parameter

Description

a

Name of the value to be deleted.

b

(optional) true (profile context) or false (system-wide context). Default: false.


GUI


See section Constants (administration) for system-wide permanent values.

See section Profile Values for profile-wide permanent values.

Examples


Defined are the two permanent values, both with the name myKey and saved in the system-wide context with value DataValue and in the profile context with value ProfileValue.


Parameter a

Parameter b

Result

myOtherKey


(Empty string with set Empty Flag)

myOtherKey


(Empty string with set Empty Flag)

myKey

true

ProfileValue

myKey

true

(Empty string with set Empty Flag, since deleted in the first function call)

myKey

false

DataValue

myKey

false

(Empty string with set Empty Flag, since deleted in the first function call)