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

  m6_FiltCount():

  Purpose:  Retrieves the number of indexed records set in the specified
            filter.

   Syntax:  m6_FiltCount( <nHandle> )

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

  Returns:  The number of indexed records set in the specified filter.

     Note:  If the filter is partially optimizable, then this count may not
            be accurate, as it may contain records that will fall out of
            scope once the non-indexed portion of the filter condition is
            tested against the database record it corresponds to.  See
            m6_EvalPartial() for details on how to remove the uncertainty in
            partially optimizable filters.

            *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_FiltCount( nHandle )               //  2