Click above to get retro games delivered to your door ever month!

   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);
     }