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

  m6_FiltSkip():

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

   Syntax:  m6_FiltSkip( <nHandle>, [<nSkipCount>] )

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

            <nSkipCount>  --  Is the number of records to skip. One is
                              the default.  A negative values indicates
                              a backwards skip.

  Returns:  The value of the record this function positioned to.  A return
            value of 0 indicates an error or that there are no more records in
            the filter.

     Note:  Filters are always stored in record number order. Therefore when
            you skip forward you should expect the filter record numbers to
            increase, and likewise decrease when you skip backwards.

            *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

         //....................................skip to next filter record
         ? m6_FiltSkip( nHandle )       //   5
         ? m6_FiltSkip( nHandle )       //  10
         ? m6_FiltSkip( nHandle )       //   0