action_="hashget"

<do action_="hashget"> retrieves the value associated with a given key from the user-specific private store. (Available as of version 10.23)

Syntax

<dynamic all_values="{pkg(;)}" var="">
    <do action_="hashget" 
     key_="[KEY]" value_="@var"
     pkgvalue_="@all_values" strict_="0|1"/>
</dynamic>

Attributes for action_="hashget"

key_
Specifies the key whose value is to be retrieved from the store.
value_
The dynamic variable associated with the value_ attribute is set to a package containing information about the key specified by the key_ attribute.

The variable must be declared as a package in the opening <dynamic> tag of the QuickApp (e.g., <dynamic var_name="{pkg(;)}">).

pkgvalue_
The dynamic variable associated with the pkgvalue_ attribute is set to a package containing information about the user's entire store (key_ and value_ are optional).

The variable must be declared as a package in the opening <dynamic> tag of the QuickApp (e.g., <dynamic var_name="{pkg(;)}">).

strict_
Determines whether or not to display an error if the given key is not present in the store. Accepts a 1 or 0.

When strict_="1", an error is thrown if the specified key is not in the store.

When strict_="0", the variable specified by the value_ attribute is set to the empty string if the specified key is not in the store.

The default is 0.

Example: Get the list of keys currently stored

<dynamic my_hash="{pkg(;)}" names="">
  <do action_="hashget" pkgvalue_="@my_hash"/>
  <widget class_="text" text_="{pkg_names(@my_hash)}"/>
</dynamic>