Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

Dictionary.Lookup

Looks up value for the key.

Component Version macOS Windows Linux Server iOS SDK
Dictionary 12.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "Dictionary.Lookup"; DictionaryRef; Key { ; DefaultValue } )   More

Parameters

Parameter Description Example Flags
DictionaryRef The reference number to the dictionary. $dic
Key The key to use. Keys are case sensitive. "FirstName"
DefaultValue The default value to return if key is not found.
Default for the default value is an empty string.
"" Optional

Result

Returns value or error.

Description

Looks up value for the key.
As dictionary preserves data type, result can be empty, text, number, date, time, timestamp, container or boolean.
Returns default value (or empty result), if key is not found.

Similar to Dictionary.ValueForKey, but without an error, but a default value.

Examples

Query UUID for something and make new one if it's not found:

MBS( "Dictionary.Lookup"; $IDDic; $id; Get(UUID) )

See also

Release notes

Blog Entries

This function checks for a license.

Created 15th February 2022, last changed 24th November 2023


Dictionary.List - Dictionary.Release