ccvs_lookup
Name
ccvs_lookup — Looks up information about an item in
the database.
Synopsis
string ccvs_lookup(session, status, index);
string session: ID of
session to use
string status: Status of
transaction to look up
integer index: Index of
transaction to look up
Returns
Invoice name or 'NONE' on success; 'syntax error' or
'uninitialized' on error
Description
ccvs_lookup() fetches and returns information
about a transaction with the status given by status , which must be a valid CCVS
status string. Since there may be many transactions with
a given status at any one time, you use index to indicate which one you want. For
instance, if you know there are several authorized but
unprocessed transactions in the system and you want to
find out the invoice name for the fifth one, you give a
status ofauth and an
index of5. Counting
starts from1. session
must be a valid session ID as returned by ccvs_init() .
If no matching transactions were found, NONE is
returned.
Version
PHP 4 since 4.0.2
Example
Example 91. Look up
information on transactions
echo "Looking up a transaction's invoice name:\n";
$ret = ccvs_lookup($session, 'new', 1);
echo "Returned: '$ret'; Return type: " . gettype($ret) . "\n";
echo "Textvalue: " . ccvs_textvalue($session) . "\n\n";
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.
PhpDig.net