man3mngr/FindNextConfMatch

Table of Contents

Name

FindNextConfMatch - find entries in the CONFLIST database

Description

FindNextConfMatch traverses the CONFLIST array looking for a match using Lpnt and Dpnt as a criteria.

The function returns a pointer to a CONFLIST record which matches and the index value where the match occurred. Subsequent calls to FindNextConfMatch will find subsequent matches in the array.

This function is part of libmngr.

Syntax

CONFLIST *FindNextConfMatch (
   CONFLIST CFpnt[],

   int Size,

   int *Idx,

   LABEL *Lpnt,

   DESC *Dpnt

   );

Arguments

CFpnt

The pointer to the start of the CONFLIST array

Size

the size of the CONFLIST array.

Idx

a pointer to an integer containing the current array index. The first time this function is called Idx should be initialized to zero.

Lpnt

a pointer to a LABEL record

Dpnt

a pointer to a DESC record

Return Value

a CONFLIST pointer is returned on success.
null is returned on failure.

Notes

When calling this function the 1st time, the calling routine must initialize *Idx to zero OR to the desired offset in the CONFLIST array.

Subsequent calls will reuse the value of Idx.

If the end of the array is reached w/o finding a match NULL is returned and Idx is set to -1;

See Also

libmngr(3mngr)

Manual page revision

$Id: FindNextConfMatch.3,v 1.1 2002/04/07 18:35:52 kitchen Exp $


Table of Contents