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 |