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

  m6_FiltGoRec():

  Purpose:  Positions internal filter pointer to a specified record.
            This function will not reposition the database record pointer.

   Syntax:  m6_FiltGoRec( <nHandle>, <nRecord> )

    Where:  <nHandle>     --  Is a handle to a previously allocated
                              filter.

            <nRecord>     --  Record to position the filter to.

  Returns:  The value of the last record in the filter.  A return value of
            0 indicates an error or that the specified record is out of
            range.

     Note:  *Always free RYO filters that are no longer being used.*

  Example:

         #include "SIXCDX.CH"
         #include "MACHSIX.CH"

         //.............................................use customer file
         USE Customer via "SIXCDX"

         //.............................................create RYO filter
         nHandle := m6_NewFilter()

         //......................................add records to the filter
         ? m6_FiltAddRec( nHandle,  5 )  // .T.
         ? m6_FiltAddRec( nHandle, 10 )  // .T.

         //...........................position filter pointer to record 2
         ? m6_FiltGoRec( nHandle, 2 )        //  2

         //..................................... is this record set?  No.
         ? m6_IsFiltRec( nHandle, 2 )    // .F.

         //...now position to record 10 (we know this one is in the filter)
         ? m6_FiltGoRec( nHandle, 10 )       // 10

         //......................................is this record set?  Yes!
         ? m6_IsFiltRec( nHandle, 10 )   // .F.