setprops

Gamma: Version 4.0
Prev |  | Next

# `setprops`

`setprops` -- lists the most recent property value settings.

## Syntax

    setprops (symbol, properties)

## Arguments

`symbol`

  The symbol whose properties will be listed.

`properties`

  Any property.

## Returns

A list of properties with their most recent values, as associated pairs.

## Description

This function is used to get a list of all the properties and their associated values as (name . value) pairs. It is called using any of the symbol's properties. The list contains current values in order from the most to least recently entered.

The `symbol` and `property` are normally protected from evaluation when setting properties, using the `#` operator.

## Example

        Gamma> setprop(#weight,#hilimit,1000);
        nil
        Gamma> setprop(#weight,#lowlimit,500);
        nil
        Gamma> setprop(#weight,#warning,950);
        nil
        Gamma> setprop(#weight,#warning,975);
        950
        Gamma> setprops(#weight,#hilimit);
        ((warning . 975) (lowlimit . 500) (hilimit . 1000))
        Gamma>

## See Also

`setprop`

Prev | Home | Next
`setprop` | Up | `trap_error`

Copyright 1995-2002 by Cogent Real-Time Systems, Inc.