Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- db_VISTA III - d_discon http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
   D_DISCON

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

ARGUMENTS
   SET         The set type from whitch current member is to be disconnected.
   dbn         (optional) The number of the database containing the record

DESCRIPTION
    Function d_discon disconnects the current member from SET. The current
    record will become the disconnected record and the new current member
    will become the next member of SET. Status S_EOS is returned when the
    last member (i.e. the one at the end of the set) has been disconnected.
    This function does not delete the record.

CURRENCY CHANGES
    curr_rec=curr_mem[set];
    curr_mem[set]=next member of SET;

RETURN CODES
    1    S_EOS         End of set. You've just disconnected the last
                       member of set.

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

   -8    S_NORO        The current owner is null.

   -9    S_NOCM        The current member is null.

   -24   S_NOTLOCKED   Set type is not locked.

   -27   S_TRNOTACT    Transaction not active. In shared mode, changes can
                       only be made from within a transaction

EXAMPLE
   /* disconnect and delete abstract */
   d_setom(ABSTRACT,HAS_PUBISHED);
   while (d_findfm(ABSTRACT)==S_OKAY) {
         d_discon(ABSTRACT);
         d_delete();
   }

See Also: d_connect d_disdel

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson