NAME

       VistaIOInsertAttr, VistaIOAppendAttr, VistaIOPrependAttr - add an attribute to a list

SYNOPSIS

       void VistaIOInsertAttr (posn, after, name, dict, repn, value)
              VistaIOAttrListPosn *posn;
              VistaIOBoolean after;
              VistaIOStringConst name;
              VistaIODictEntry *dict;
              VistaIORepnKind repn;
              type value;

       void VistaIOAppendAttr (list, name, dict, repn, value)
              VistaIOAttrList list;
              VistaIOStringConst name;
              VistaIODictEntry *dict;
              VistaIORepnKind repn;
              type value;

       void VistaIOPrependAttr (list, name, dict, repn, value)
              VistaIOAttrList list;
              VistaIOStringConst name;
              VistaIODictEntry *dict;
              VistaIORepnKind repn;
              type value;

       where   type   is   VistaIOBit,  VistaIOUByte,  VistaIOSByte,  VistaIOShort,  VistaIOLong,  VistaIOFloat,
       VistaIODouble,   VistaIOAttrList,    VistaIOBoolean,    VistaIOBundle,    VistaIOList,    VistaIOPointer,
       VistaIOString, VistaIOEdges, VistaIOImage, etc.

ARGUMENTS

       posn      Specifies the attribute list position at which a new attribute is to be inserted.

       after     Specifies whether a new attribute is to be inserted before posn (FALSE) or after posn (TRUE).

       list      Specifies the attribute list to which a new attribute is to be appended or prepended.

       name      Specifies a name for the new attribute.

       dict      May  specify a dictionary to be used in translating the value supplied to a keyword that should
                 be stored as the attribute's value, or it may be NULL

       repn      Specifies the representation of the new attribute value.

       value     Specifies the new attribute value.

DESCRIPTION

       These routines provide three ways of adding a new attribute to an attribute list:

         • VistaIOInsertAttr inserts the new attribute  immediately  before  or  after  the  existing  attribute
           specified by posn.

         • VistaIOAppendAttr places the new attribute at the end of list.

         • VistaIOPrependAttr places the new attribute at the beginning of list.

       With the dict argument you can provide a dictionary for mapping value to a keyword that will be stored as
       the attribute's value (see VistaIOdictionary(3)). For example, if you pass an attribute value of 1 and  a
       dictionary  that  associates  the value 1 with the keyword ubyte (as the dictionaryVistaIORepnDict does),
       then the string ubyte will be stored as the attribute's value. Dictionaries  may  be  used  to  map  both
       numeric  values  and  strings  to keywords. If you supply a dictionary but value is not mentioned in that
       dictionary, then value itself will be stored with the attribute.

       If value is a number or a character string, the routine makes its own copy of the value  as  a  character
       string  for  storing in the attribute. If, on the other hand, value is an attribute list, pointer, image,
       edge set, etc., then the routine stores a pointer in the attribute but it does not make  a  copy  of  the
       object pointed to.

RETURN VALUES

       As a side effect, these routines modify the attribute list referred to by list or posn.

SEE ALSO

       VistaIOSetAttr(3), VistaIOSetAttrValue(3),
       VistaIOattribute(3), VistaIOdictionary(3),

AUTHOR

       Art Pope <pope@cs.ubc.ca>

       Adaption to vistaio: Gert Wollny <gw.fossdev@gmail.com>