man3mngr/rmt_FindNextConfMatch

Table of Contents

Name

rmt_FindNextConfMatch - find entries in the CONFLIST database

Description

rmt_FindNextConfMatch traverses the CONFLIST array looking for a match using a Label and RefName 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 rmt_FindNextConfMatch will find subsequent matches in the array.

This function is part of libmngr.

Syntax

CONFLIST *rmt_FindNextConfMatch (
   CONFLIST CFpnt[],

   int Size,

   int *Idx,

   char *L,

   char *D

   );

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.

L

a Label

D

a RefName

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: rmt_FindNextConfMatch.3,v 1.1 2002/04/07 18:35:52 kitchen Exp $


Table of Contents