Foundation 6

Fnd_Dict

40 shared methods.

Fnd_Dict_DataType

Fnd_Dict_DataType (dict ID; key name) --> Number

Returns the data type of a key.

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
keyTextinKey name
ResultLongintoutData type

Fnd_Dict_GetArray

Fnd_Dict_GetArray (dict ID; key name; ->values)

Returns an array of values from a dictionary given a key.

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
keyTextinKey name
valuePointerinText array to receive values

Fnd_Dict_GetBoolean

Fnd_Dict_GetBoolean (dict ID; key) --> Boolean

Returns a Boolean value from a dictionary given a key.

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
keyTextinKey name
ResultBooleanoutThe key's value

Fnd_Dict_GetDate

Fnd_Dict_GetDate (dict ID; key) --> Date

Returns a date value from a dictionary given a key.

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
keyTextinKey name
ResultDateoutThe key's value

Fnd_Dict_GetLongint

Fnd_Dict_GetLongint (dict ID; key) --> Longint

Returns a longint value from a dictionary given a key.

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
keyTextinKey name
ResultLongintoutThe key's value

Fnd_Dict_GetPointer

Fnd_Dict_GetPointer (dict ID; key) --> Pointer

Returns a pointer value from a dictionary given a key.

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
keyTextinKey name
ResultPointeroutThe key's value

Fnd_Dict_GetReal

Fnd_Dict_GetReal (dict ID; key) --> Real

Returns a real value from a dictionary given a key

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
keyTextinKey name
ResultRealoutThe key's value

Fnd_Dict_GetText

Fnd_Dict_GetText (dict ID; key) --> Text

Returns a text value from a dictionary given a key.

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
keyTextinKey name
ResultTextoutThe key's value

Fnd_Dict_GetTime

Fnd_Dict_GetTime (dict ID; key) --> Time

Returns a time value from a dictionary given a key.

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
keyTextinKey name
ResultTimeoutThe key's value

Fnd_Dict_GetValue

Fnd_Dict_GetValue (dict ID; key) --> Text

Returns a value from a dictionary given a key

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
keyTextinKey name
ResultTextoutThe key's value as text

Fnd_Dict_HasKey

Fnd_Dict_HasKey (dict ID; key) --> Boolean

Checks whether a dictionary contains a given key.

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
keyTextinKey name
ResultBooleanoutTrue if the key exists

Fnd_Dict_ID

Fnd_Dict_ID (name) --> Number

Returns the reference number of the dictionary with the specified name.

Returns 0 if the dictionary does not exist.

ParameterTypeDirectionDescription
nameTextinA dictionary name
ResultLongintoutThe dictionary's reference number

Fnd_Dict_Info

Fnd_Dict_Info (label) --> Text

Returns requested information. See the Fnd_Gen_ComponentInfo method for more information.

ParameterTypeDirectionDescription
requestTextinInfo desired ("version" or "name")
ResultTextoutResponse

Fnd_Dict_IsValid

Fnd_Dict_IsValid (dict ID) --> Boolean

Checks whether a dictionary reference is valid.

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
ResultBooleanoutTrue if the dictionary reference is valid

Fnd_Dict_ItemCount

Fnd_Dict_ItemCount (dict ID) --> Number

Returns the number of items in a dictionary.

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
ResultLongintoutItem count

Fnd_Dict_Key

Fnd_Dict_Key (dict ID; key number) --> Text

Returns the nth key from a dictionary.

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
indexLongintinKey number
ResultTextoutThe key's value as text

Fnd_Dict_Keys

Fnd_Dict_Keys (dict ID; ->keys array)

Fills an array with the keys in a dictionary.

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
arrayPointerinText array

Fnd_Dict_Load

Fnd_Dict_Load (->blob or path)

Loads a dictionary from either a blob or a file

ParameterTypeDirectionDescription
sourcePointerinDictionary or path
ResultLongintoutDictionary ID

Fnd_Dict_LoadFromBlob

Fnd_Dict_LoadFromBlob (->blob) --> Longint

Loads a dictionary from a BLOB.

ParameterTypeDirectionDescription
sourcePointerinDictionary as blob
ResultLongintoutDictionary ID

Fnd_Dict_LoadFromFile

Fnd_Dict_LoadFromFile (path) --> Longint

Loads a dictionary from a file.

ParameterTypeDirectionDescription
filenameTextinFile path
ResultLongintoutDictionary ID

Fnd_Dict_LockInternalState

Fnd_Dict_LockInternalState (lock?)

Locks the internal state for the dictionary module.

ParameterTypeDirectionDescription
lockBooleaninTrue to Lock, False to Unlock

Fnd_Dict_Name

Fnd_Dict_Name (dict ID) --> Text

Returns the name of the dictionary.

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
ResultTextoutDictionary Name

Fnd_Dict_New

Fnd_Dict_New ({name}) --> Longint

Creates a new dictionary and returns a refernece to it.

ParameterTypeDirectionDescription
inNameTextinName (optional)
ResultLongintoutDictionary ID

Fnd_Dict_Release

Fnd_Dict_Release (dict ID)

Decrements the retain count of a dictionary and deletes it when the retain count reaches 0.

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID

Fnd_Dict_Remove

Fnd_Dict_Remove (dict ID; key)

Removes a key from a dictionary.

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
keyTextinKey name

Fnd_Dict_Retain

Fnd_Dict_Retain (dict ID)

Increments the retain count for a dictionary.

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID

Fnd_Dict_RetainCount

Fnd_Dict_RetainCount (dict ID) --> Longint

Returns the retain count for a dictionary

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
ResultLongintoutRetain count

Fnd_Dict_Save

Fnd_Dict_Save (dict ID; ->blob or path)

Saves a dictionary as either a blob or a file.

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
blobPathPointerinBlob or path

Fnd_Dict_SaveToBlob

Fnd_Dict_SaveToBlob (dict ID; ->blob)

Saves a dictionary as a blob.

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
destinationPointerinBlob to store dictionary

Fnd_Dict_SaveToFile

Fnd_Dict_SaveToFile (dict ID; path)

Saves a dictionary as a file.

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
filenameTextinPath to the file to create (or update)

Fnd_Dict_SetArray

Fnd_Dict_SetArray (dict ID; key; ->array)

Stores an array of values inside a dictionary.

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
keyTextinKey
valuePointerinArray

Fnd_Dict_SetBoolean

Fnd_Dict_SetBoolean (dict ID; key; Boolean value)

Assigns a Boolean value to a dictionary given a key.

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
keyTextinKey name
valueBooleaninValue to store

Fnd_Dict_SetDate

Fnd_Dict_SetDate (dict ID; key; date value)

Assigns a date value to a dictionary given a key.

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
keyTextinKey name
valueDateinValue to store

Fnd_Dict_SetLongint

Fnd_Dict_SetLongint (dict ID; key; longint value)

Assigns a longint value to a dictionary given a key.

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
keyTextinKey name
valueLongintinValue to store

Fnd_Dict_SetPointer

Fnd_Dict_SetPointer (dict ID; key; pointer)

Assigns a pointer value to a dictionary given a key

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
keyTextinKey name
valuePointerinPointer to store

Fnd_Dict_SetReal

Fnd_Dict_SetReal (dict ID; key; real value)

Assigns a real value to a dictionary given a key

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
keyTextinKey name
valueRealinValue to store

Fnd_Dict_SetText

Fnd_Dict_SetText (dict ID; key; text value)

Assigns a text value to a dictionary given a key

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
keyTextinKey name
valueTextinValue to store

Fnd_Dict_SetTime

Fnd_Dict_SetTime (dict ID; key; time value)

Assigns a time value to a dictionary given a key

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
keyTextinKey name
valueTimeinValue to store

Fnd_Dict_SetValue

Fnd_Dict_SetValue (dict ID; key; value as text; data type)

Assigns a value to a dictionary given a key

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
keyTextinKey name
valueTextinValue to store
typeLongintinData type

Fnd_Dict_Values

Fnd_Dict_Values (dict ID; ->array)

Fills an array with the values in a dictionary.

ParameterTypeDirectionDescription
dictionaryLongintinDictionary ID
arrayPointerinArray to receive values