Definition: | object data = getd(object key, integer tid=1) |
Description: |
Retrieve the data corresponding to the specified key.
tid can be omitted, to use the default dictionary, or the result of a previous new_dict() call. |
Comments: |
If the key does not exist, a default value is returned, which is initially NULL but can be overridden via
setd_default(). 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 |