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

   D_FINDNM

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

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

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

DESCRIPTION
   This function finds next 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]=next member (NULL_DBA when S_EOS);
   curr_rec=next 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);
     }