[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 NUMCOUNT()
 Uses the internal CA-Clipper Tools counter
------------------------------------------------------------------------------
 Syntax

     NUMCOUNT([<nIncrement|nStartValue>,[<lMode>]])
         --> nNewCounterValue

 Arguments

     <nIncrement|nStartValue>  Designates the incremental value for the
     internal counter or a new starting value.

     <lMode>  Designates whether <nIncrement|nStartValue> is a new
     starting value (.T.) or an increment (.F.).  The default is increment
     (.F.).

     () Without parameters, the current counter value is returned.

 Returns

     When called without parameters, this function returns the current
     counter value; otherwise, it always returns the new counter value.

 Description

     Always increment count variables and retain the current status when you
     program counting events.  Use NUMCOUNT() to simplify this process.  When
     you call NUMCOUNT(), the internal counter is increased and the new
     counter status is returned to the calling program.  The count variable
     is then queried and actualized in one step.

 Example

     Data is not output with line numbers, but with a running counter:

     NUMCOUNT(0, .T.)      // Set 0 as a starting value..
     LIST OFF NUMCOUNT(1), CUST FOR REBATE


This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson