DtFindProperty(3Dt) DtFindProperty(3Dt)
NAME
DtFindProperty - find properties with specified attributes
SYNOPSIS
#include <Dt/Desktop.h>
DtPropPtr DtFindProperty(DtPropListPtr plistp, DtAttrs attrs);
DESCRIPTION
The DtFindProperty function finds properties in the list
plistp with a specified set of attrs.
The first call with plistp specified returns a pointer to the
first property in plistp with the specified attrs set. The
function keeps track of its position within the property list,
so that subsequent calls (plistp must be NULL) work through
the property list until all matches are found.
The argument attrs may be different from call to call.
This is similar to the strtok function.
RETURN VALUES
On success, DtFindProperty returns a DtPropPtr, which includes
the following members:
DtAttrs attrs;
char *name;
char *value;
On failure, DtFindProperty returns NULL.
Copyright 1994 Novell, Inc. Page 1