D_FINDFM

SUMMARY
d_findfm(SET[,dbn])
int SET;
int dbn;

ARGUMENTS
SET Set type for which the first member is to be found.

dbn (optional) The number of the database containing the record.

DESCRIPTION
This function finds first member of the current owner of SET. The current
member of SET and the current record will be set to the found record.Status
S_EOS is returned if there are no members in the set.


CURRENCY CHANGES
curr_mem[SET]=first member;
curr_rec=first member;


RETURN CODES
1 S_EOS Set is empty.

-2 S_INVSET Invalid set type. Probably passed a record or
field type instead of a set type.

-8 S_NOCO The current owner is null.

-24 S_NOTLOCKED Set type is not locked.


EXAMPLE

/* print author list in ascending order */
for (d_findfm(AUTHOR_LIST);db_status==S_OKAY;d_findnm(AUTHOR_LIST)
{
d_crread(NAME,name);
printf ("author %s \n",name);
}