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

USAGE
   int scdnktop(
           int handle,
           void *key,
           long *recno );

PROTOTYPE IN
   sc_base.h

DESCRIPTION
   scdnktop will set the current key pointer to the first logical key in
   the index and return the key value key and data record number recno
   associated with the new current key.

NOTES
   The user must ensure that the buffer used to return the key is large
   enough to hold the entire key. The maximum length of the key can be
   determined via a call to scdninfo.

   Numeric keys are returned as doubles, and character keys are returned as
   strings.

EXAMPLE
   /*  Character Key Example  */
   #include <stdio.h>
   #include <softc.h>
   #include <sc_base.h>
   void main()
   {
     int ndx;
     char name[65];
     long recno;

     scdinit(20,0);
     if (scdnopenx(&ndx,"TOCNAME.NDX",SC_BUFFER) == SC_SUCCESS) {
       name[64] = 0;
       scdnktop(ndx,name,&recno);
       printf("%s %ld\n",name,recno);
       scdnclose(ndx);
     }
     scdterm();
   }

   /*  Numeric Key Example  */
   #include <stdio.h>
   #include <softc.h>
   #include <sc_base.h>

   void main()
   {
     int ndx;
     double length;
     long recno;

     scdinit(20,0);
     if (scdnopenx(&ndx,"TOCLNGTH.NDX",SC_BUFFER) == SC_SUCCESS) {
       scdnktop(ndx,&length,&recno);
       printf("%lf %ld\n",length,recno);
       scdnclose(ndx);
     }
     scdterm();
   }