Lingo Dictionary > G-K > getaProp |
![]() |
getaProp
Syntax
propertyList.propertyName
getaProp(
list
,
item
)
list
[listPosition
]propertyList [ #propertyName ]
propertyList [ "propertyName" ]
Description
List command; for linear and property lists, identifies the value associated with the item specified by item
, listPosition
, or propertyName
in the list specified by list
.
![]() |
When the list is a linear list, replace |
![]() |
When the list is a property list, replace |
The getaProp
command returns VOID
when the specified value is not in the list.
When used with linear lists, the getaProp
command has the same function as the getAt
command.
Example
This statement identifies the value associated with the property #joe in the property list ages, which consists of [#john:10, #joe:12, #cheryl:15, #barbara:22]:
put getaProp(ages, #joe)
The result is 12, because this is the value associated with the property #joe.
Example
The same result can be achieved using bracket access on the same list:
put ages[#joe]
The result is again 12.
Example
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
![]() |