Adobe 65036570 Scripting Guide - Page 355

ADOBE DIRECTOR 11.0 318 Scripting Dictionary put ages[#joe] The result is again 12. If you want the value at a certain position in the list, you can also use bracket access. To get the third value in the list, associated with the third property, use this syntax: put ages[3] -- 15 Note: Unlike the getAProp command where VOID is returned when a property doesn't exist, a script error will occur if the property doesn't exist when using bracket access. See also getAt, getOne(), getProp(), setaProp, setAt getAt Usage getAt(list, position) list [position] Description List command; identifies the item in a specified position of a specified list. If the list contains fewer elements than the specified position, a script error occurs. The getAt command works with linear and property lists. This command has the same function as the getaProp command for linear lists. This command is useful for extracting a list from within another list, such as the deskTopRectList. Parameters list Required. Specifies the list from in which the item exists. position Required. Specifies the index position of the item in the list. Example This statement causes the Message window to display the third item in the answers list, which consists of [10, 12, 15, 22]: put getAt(answers, 3) -- 15 The same result can be returned using bracket access: put answers[3] -- 15 The following example extracts the first entry in a list containing two entries that specify name, department, and employee number information. Then the second element of the newly extracted list is returned, identifying the department in which the first person in the list is employed. The format of the list is [["Dennis", "consulting", 510], ["Sherry", "Distribution", 973]], and the list is called employeeInfoList. firstPerson = getAt(employeeInfoList, 1) put firstPerson -- ["Dennis", "consulting", 510]