pg_sendquery_prepared

Name

pg_sendquery_prepared -- send a request to execute a prepared statement to the backend connection, without waiting for a result

Synopsis

pg_sendquery_prepared conn statementName ?args?

Description

pg_sendquery_prepared submits a command to the PostgreSQL server. This function works like pg_exec, except that it does not return a result. Rather, the command is issued to the backend asynchronously.

The result is either an error message or nothing. An empty return indicates that the command was dispatched to the backend.

Arguments

conn

The handle of the connection on which to execute the command.

statementName

The name of the prepared SQL statement to execute asynchronously.

args

args consists of zero or more optional values that can be inserted, unquoted, into the SQL statement using $-style substitution.

Return Value

A Tcl error will be returned if pgtcl was unable to issue the command. Otherwise, an empty string will be return. It is up to the developer to use pg_getresult to obtain results from commands issued with pg_sendquery.