What is PhpDig?
PhpDig is a PHP MySQL based
Web Spider & Search Engine.

ccvs_count
Prev	VI. CCVS Functions	Next

ccvs_count

Name

ccvs_count — Counts the number of invoices with a certain status.

Synopsis

int ccvs_count(session, status); string session: ID of session to use string status: Count transactions having this status

Returns

Number of matching invoices on success; 0 on failure

Description

ccvs_count() returns the number of invoices in a given state. Any of the status strings plus the string all may be used; all returns the total number of invoices in the session. session must be a valid session ID as returned by ccvs_init() .

Note that this function returns 0 on error or if there are no matching invoices. In this case, you can use ccvs_textvalue() to resolve the ambiguity. If an error has occurred in ccvs_count() , ccvs_textvalue() returns the empty string, and if no error occurred but no matching invoices were found, a string is returned containing the specified status and the number found.

Version

PHP 4 since 4.0.2

Example

Example 87. Count invoices

/* The following code produced this output: 
 * Counting new invoices:
 * Returned: '1'; Return type: integer
 * Textvalue: new {1} 
 * 
 * Counting all invoices:
 * Returned: '1'; Return type: integer
 * Textvalue: new {1} authorized {0} ready {0} done {0} unauthorized {0} denied {0} review {0} bad {0} 
 * 
 * Counting invoices having an invalid status:
 * Returned: '0'; Return type: integer
 * Textvalue: 
 */
echo "Counting new invoices:\n";
$ret = ccvs_count($session, 'new');
echo "Returned: '$ret'; Return type: " . gettype($ret) . "\n";
echo "Textvalue: " . ccvs_textvalue($session) . "\n\n";

echo "Counting all invoices:\n";
$ret = ccvs_count($session, 'all');
echo "Returned: '$ret'; Return type: " . gettype($ret) . "\n";
echo "Textvalue: " . ccvs_textvalue($session) . "\n\n";

echo "Counting invoices having an invalid status:\n";
$ret = ccvs_count($session, 'ndew');
echo "Returned: '$ret'; Return type: " . gettype($ret) . "\n";
echo "Textvalue: " . ccvs_textvalue($session) . "\n\n";

Prev	Home	Next
ccvs_command	Up	ccvs_delete

PHP Functions Essential Reference. Copyright © 2002 by New Riders Publishing (Authors: Zak Greant, Graeme Merrall, Torben Wilson, Brett Michlitsch). This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later (the latest version is presently available at http://www.opencontent.org/openpub/). The authors of this book have elected not to choose any options under the OPL. This online book was obtained from http://www.fooassociates.com/phpfer/ and is designed to provide information about the PHP programming language, focusing on PHP version 4.0.4 for the most part. The information is provided on an as-is basis, and no warranty or fitness is implied. All persons and entities shall have neither liability nor responsibility to any person or entity with respect to any loss or damage arising from the information contained in this book.