DICTGETSTARTASSOC

Syntax

UINT = DictGetStartAssoc(dict as POINTER)

Description

Starts a map iteration by returning a POSITION value that can be passed to a GetNextAssoc command.

Parameters

dict - Pointer to an associative array created with the DICTCREATE command.

Return value

A POSITION value that indicates a starting position for iterating the array; or NULL if the array is empty.

Remarks

None

Example usage

PRINT:PRINT "Iterating":PRINT "---------"
pos = DictGetStartAssoc(myDict)
WHILE pos
    pAssoc = DictGetNextAssoc(myDict,pos)
    PRINT DictGetKey(pAssoc)," ",DictGetValue(pAssoc)
ENDWHILE