Lingo Dictionary > A-C > addProp |  |

addProp

Syntax

    list.addProp(property, value)
    addProp list, property, value

Description

Property list command; for property lists only, adds the property specified by `property` and its value specified by `value` to the property list specified by `list`. For an unsorted list, the value is added to the end of the list. For a sorted list, the value is placed in its proper order.

If the property already exists in the list, Lingo creates a duplicate property. You can avoid duplicate properties by using the `setaProp` command to change the new entry's property.

This command returns an error when used with a linear list.

Example

This statement adds the property named `kayne` and its assigned value 3 to the property list named `bids`, which contains [#gee: 4, #ohasi: 1]. Because the list is sorted, the new entry is placed in alphabetical order:

    bids.addProp(#kayne, 3)

The result is the list [#gee: 4, #kayne: 3, #ohasi: 1].

Example

This statement adds the entry `kayne: 7` to the list named `bids`, which now contains [#gee: 4, #kayne: 3, #ohasi: 1]. Because the list already contains the property `kayne`, Lingo creates a duplicate property:

    bids.addProp(#kayne, 7)

The result is the list [#gee: 4, #kayne: 3, #kayne: 7, #ohasi: 1].