GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
PQregisterComposites(3) libpqtypes Manual PQregisterComposites(3)

PQregisterComposites - Registers a composites.

#include <libpqtypes.h>
int PQregisterComposites(PGconn *conn, PGregisterType *types, int count);

THIS FUNCTION IS DEPRECATED. New applications should use PQregisterTypes. This function is now a wrapper to PQregisterTypes.

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.

The example registers two composite types.
PGregisterType comp_types[] = {
	{"myschema.simple", NULL, NULL},
	{"complex", NULL, NULL}
};
if (!PQregisterComposites(conn, comp_types, 2))
	fprintf(stderr, "PQregisterComposites: %s\n", PQgeterror());

On success, a non-zero value is returned. On error, zero is returned and PQgeterror(3) will contain an error message.

None.

A contribution of eSilo, LLC. for the PostgreSQL Database Management System. Written by Andrew Chernow and Merlin Moncure.

Report bugs to <libpqtypes@esilo.com>.

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.

pqt-handlers(3), PQputf(3), PQgetf(3)

2011 libpqtypes

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.