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

   D_ISOWNER

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

ARGUMENTS
   SET         The set type for which the current record's ownership will be
               checked.

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

DESCRIPTION

   This function determines whether or not the current record has any
   members connected to it through SET. If it does, the status S_OKAY is
   returned. If not, status S_EOS is returned.

-------------------------------------------------------------------
NOTE

   If the current record is not a legal member of SET, d_ismember will
   return an error code of -19, which will in turn call dberr.

-------------------------------------------------------------------

CURRENCY CHANGES
   None

RETURN CODES

     0   S_OKAY             The current record is an owner of a non-empty
                            occurence of SET.

     1   S_EOS              End of set. The current record is not currently
                            connected as a owner of SET.

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

    -7   S_NOCR             The current record is null.

   -18   S_INVOWN           Current record is not a legal owner of SET.

EXAMPLE


      if (d_isowner(ALTERNATE_SET_1)==S_OKAY) {
         /* process set 1 records */
         ...
      }
      else if (d_isowner(ALTERNATE_SET_2)==S_OKAY) {
         /* process set 2 records */
         ...
      }
      else if (d_isowner(ALTERNATE_SET_3)==S_OKAY) {
         /* process set 3 records */
         ...
      }