PQregisterComposites - Registers a composites.
Contents
Copyright
Copyright (c) 2011 eSilo, LLC. All rights reserved.
This is free software; see the source for copying conditions. There is NO warranty; not even for
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
Deprecated
THIS FUNCTION IS DEPRECATED. New applications should use PQregisterTypes. This function is now a
wrapper to PQregisterTypes.
Description
The PQregisterComposites() function allows an application to register one or more composites. This
function can be called as many times as an application needs on a PGconn.
This function must execute a query against the backend to retrieve type information for each composite,
thus this should not be called from within a transaction. It is recommended to register multiple
composites at the same time to avoid round trip overhead.
The types argument is an array containing count composite types to register. Composites do not use the
typput or typget members of the PGregisterType structure, thus these memebrs are ignored. If any
composite does not exist, the register is aborted.
NOTE: The typname member of the PGregisterType structure can optionally contain the type's schema:
schema.typname.
WARNING: PQparamCreate is only aware of types that have already been registered. If you need to put a
composite into a param, make sure it is first registered.
Examples
None.
Name
PQregisterComposites - Registers a composites.
Reporting Bugs
Report bugs to <libpqtypes@esilo.com>.
Return Value
On success, a non-zero value is returned. On error, zero is returned and PQgeterror(3) will contain an
error message.
See Also
pqt-handlers(3), PQputf(3), PQgetf(3) libpqtypes 2011 PQregisterComposites(3)
Synopsis
#include<libpqtypes.h>intPQregisterComposites(PGconn*conn,PGregisterType*types,intcount);
