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:

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>