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

SUMMARY
   d_crget(dba[,dbn]
   DB_ADDR *dba;
   int dbn;

ARGUMENTS
   dba         Pointer to a BD_ADRR variable to receive the database address
               of the current record.

DESCRIPTION
   This function copies the database address of the current record into the
   database address variable pointer to be dba. if the current record is null
   (NULL_DBA) error code S_NORC is returned as a status (i.e dberr is not
   called and *dba will be set to null. It is used in conjunction with the
   d_crset function for saving and restoring the current record.

--------------------------------------------------------------------------
Note:
   If the record type of the current record is timestamped, you should also
   call function d_gtscr to get its last access timestamp. When the current
   record is later restored by d_crset, function d_stscr should also be called
   to restore the last access timestamp associated with that current record.
--------------------------------------------------------------------------

CURRENCY CHANGES
   None

RETURN CODES
   -7    S_NOCR        The current record is null. Returned as a status code
                       rather than an error (i.e dberr is not called).

EXAMPLE
   DB_ADDR save_dba;
    ..
   /* save current record for later retrievial */
   d_crget(&save_bda)
    ..
   /* later, retrieve saved record */
   d_crset(&save_dba);
   d_recread(&irec);
    ..

See Also: d_crset d_csoget d_csmget d_csmset d_gtscm d_gtsco d_gtscr d_stscm d_stscr

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