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

  m6_FiltTop():

  Purpose:  Positions internal filter pointer to the first record set
            in the specified filter.  This will not reposition the database
            record pointer.  Think of it as a GO TOP, but applied to a
            filter.

   Syntax:  m6_FiltTop( <nHandle> )

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

  Returns:  The value of the first record in the filter.  A return value of
            0 indicates an error or that there was not any records in the
            filter.

     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.

         ? m6_FiltTop( nHandle )     //  5