Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Guides   Examples
New in version: 7.5   8.0   8.1   8.2   8.3   8.4   8.5   9.0   9.1   9.2    Statistic  


Creates a new dictionary.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
Dictionary 5.0 Yes Yes Yes Yes Yes
MBS( "Dictionary.Create" { ; Key; Value } )   More


Parameter Description Example value
Key Optional
Optional, a key.
Value Optional
Optional, a value.


Returns dictionary reference number or error.


Creates a new dictionary.
Dictionaries are hash maps, so lookup is very fast (often faster than search in your FileMaker database). You can use them for storing parameters or lookup tables.
Optionally you can pass keys and values as parameters to this function.

If you looked for assoziative arrays, you are right here.


Build a dictionary in a calculation:

Let ( [
Create new Dictionary
    param = MBS( "Dictionary.Create" );

    Fill in parameters
    r1 = MBS( "Dictionary.SetValueForKey"; param; "text"; Pass Parameters with Dictionary::TextField );
    r2 = MBS( "Dictionary.SetValueForKey"; param; "number"; Pass Parameters with Dictionary::NumberField);
    r3 = MBS( "Dictionary.SetValueForKey"; param; "date"; Pass Parameters with Dictionary::DateField);
    r4 = MBS( "Dictionary.SetValueForKey"; param; "time"; Pass Parameters with Dictionary::TimeField);
    r5 = MBS( "Dictionary.SetValueForKey"; param; "timestamp"; Pass Parameters with Dictionary::TimeStampField);
    r6 = MBS( "Dictionary.SetValueForKey"; param; "container"; Pass Parameters with Dictionary::ContainerField)
    return dictionary
  ] ; param )

Build a dictionary with given Keys and Values:

MBS("Dictionary.Create"; "FirstName"; $FirstName; "LastName"; $LastName; "City"; $City; "Phone"; $Phone; "Email"; $Email)

Test script to look for duplicate UUIDs:

Set Variable [ $dic ; Value: MBS( "Dictionary.Create") ]
    Set Variable [ $uuid ; Value: Get(UUID) ]
    If [ MBS("Dictionary.HasKey"; $dic; $uuid) ]
        Show Custom Dialog [ "Duplicate!" ; $uuid ]
        Exit Loop If [ 1 ]
    End If
    Set Variable [ $r ; Value: MBS( "Dictionary.SetValueForKey"; $dic; $uuid; $uuid ) ]
End Loop
Set Field [ test::test ; MBS( "Dictionary.Keys"; $dic ) ]
Set Variable [ $r ; Value: MBS( "Dictionary.Release"; $dic ) ]

See also

Example Databases

Blog Entries

Created 12nd December 2014, last changed 15th June 2017

Dictionary.Count   -   Dictionary.CreateNamed

Feedback: Report problem or ask question.

MBS Xojo Chart Plugins