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_csmset http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
   D_CSMSET

SUMMARY
   d_csmset(SET,dba[,dbn])
   int SET;
   DB_ADDR *dba;
   int dbn;

ARGUMENTS
   SET         Set type for the current member to be assigned.

   dba         Pointer to the database address to become the current
               member of SET.

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

DESCRIPTION
   Function d_csmset copies the database address pointed by dba to the
   current member of SET. The current owner of SET becomes the record that
   is the current owner of member. this function is generally used in
   conjunction with d_csmget (it can also be used with d_crget or d_csoget)
   for saving and restoring the current member of a set.

--------------------------------------------------------------------------
Note:
   If the record type of the current member is timestamped, d_stscm should
   also be called to set the last access timestamp for the current member.
--------------------------------------------------------------------------

CURRENCY CHANGES
   curr_mem[SET]=*dba;
   curr_own[SET]=owner of *dba through SET;

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

   -6    S_INVADDR      Invalid database address.You may have passed
                        the database address itself rather than a
                        pointer to it.

  -19    S_INVMEM       Record type is not a legal member of the
                        specified set.

EXAMPLE
   DB_ADDR save_dba;
    ..
   /* print key words for info record */
   DB_ADDR dba;
    ..
   /* save current member of key_to_info set in
      case info record was retrieved from a key word scan */
   d_csmget(KEY_TO_INFO,&dba);
           /* print key words thru info_to_key */
   /* restore current member */
   d_csmset(KEY_TO_INFO,&dba);
    ..

See Also: d_crget d_crset d_csoget d_csoset d_csmget d_gtscm

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