DMATTRPRINT(5ICD)

NAME
dmAttrPrint, dmAttrScan - print/scan attributes to/from an attribute string

SYNOPSIS

char *dmAttrPrint (start, remain, par, val)
char *start, *remain, *par, *val;
char *dmAttrScan (remain, par, val)
char *remain, **par, **val;

PARAMETERS

start
    is a pointer to the beginning of the attribute string.

remain
    is a pointer to the part of the attribute string that remains for writing or reading.

par is the parameter that is read or written.

val is the value that is read or written.

DESCRIPTION
Function dmAttrPrint() concatenates attributes to an attribute string used for design-data transfer. The beginning of the attribute string should be the first argument, while the part of the attribute string that remains for writing should be the second argument. Par and var are the parameter and value that form the attribute that is written. dmAttrPrint returns the part of the attribute string that is left for writing. In order to concatenate different attributes in one attribute string, the return value of dmAttrPrint can be used as a second argument in a subsequent call to dmAttrPrint.

Function dmAttrScan() reads attributes from an attribute string. The first argument should be the part of the attribute string that is still to be read. Because dmAttrScan returns the remaining part of the attribute string after the next attribute has been read, the return value of a particular call to dmAttrScan can be used as first argument for a subsequent call to dmAttrScan. The parameter that is found is returned in par, while the value that is found is returned in val (the addresses of the pointers are required).

dmAttrScan will return NULL when the input is exhausted.

LIMITATIONS
The strings denoted by par and var may not contain the characters '=' and ';'.