# getd

Definition: | object data = getd(object key, integer tid=1) -- or -- object data = getdd(object key, dflt, integer tid=1)
Description: | Retrieve the data corresponding to the specified key.
pwa/p2js: | Supported.
Comments: | tid can be omitted, to use the default dictionary, or the result of a previous new_dict() call. If the key does not exist, a default value is returned, which is initially NULL but can be overridden via setd_default() or provided on a per-call basis via getdd(). Since it is legal to store any value, there may be no default value that guarantees the key is completely absent, for such cases getd_index() can be used. Keys are case-sensitive. If case-insensitive retrieval is required, the key values as passed to setd() [etc] should be passed through either upper() or lower() and if needs be a copy of the original case included somewhere in the data.
Example: |
    ?getd("key")
See Also: | setd, getd_index