Difference between revisions of "CNTVALUES()"

From Recital Documentation Wiki
Jump to: navigation, search
(Class)
Line 1: Line 1:
 
 
 
==Purpose==
 
==Purpose==
 
Function to return the number of records matching a series of keys
 
Function to return the number of records matching a series of keys
Line 33: Line 31:
  
 
==Products==
 
==Products==
Recital Database Server, Recital Mirage Server, Recital Terminal Developer
+
Recital Server, Recital  
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Functions]]
 
[[Category:Functions]]

Revision as of 16:17, 27 November 2009

Purpose

Function to return the number of records matching a series of keys


Syntax

CNTVALUES([<for condition> [, <key expression>]])


See Also

AMAX(), AMIN(), AVERAGE, AVGVALUES(), COUNT, MAX(), MAXVALUES(), MIN(), MINVALUES(), SQLVALUES(), SUM, SUMVALUES(), TOTAL


Description

The CNTVALUES() function returns the number of records matching a series of keys. If no parameters are specified then the number of keys matching the current key is returned. An optional <for condition> can be specified to restrict the key count. You can also optionally specify a <key-expression> to perform the count on instead of the current key.

After completion, all record pointers and indexes are returned to their original positions.


Example

use customer order title 
// Number of records matching the current key
count = cntvalues()
// Number of records matching the key "Mr"
m_male = cntvalues(.T., "Mr")
// Number of records matching the current key with an expiry date < today
m_expired = cntvalues(expiry < date())


Products

Recital Server, Recital