Отправляет команду серверу без ожидания результатов. Возвращается 1, если команда была успешно отправлена, и 0, если нет (в этом случае используйте функцию PQerrorMessage для получения дополнительных сведений об ошибке).

int PQsendQuery(PGconn *conn, const char *command);

После успешного вызова функции PQsendQuery, вызовите функцию PQgetResult один или несколько раз для получения результатов. PQsendQuery нельзя вызвать повторно (через то же соединение) до тех пор, пока PQgetResult не будет возвращено значение NULL, что указывает на завершение выполнения команды.

В режиме конвейеризации использование данной функции не допускается.

Отправляет серверу команду и отдельные параметры без ожидания получения результатов.

int PQsendQueryParams(PGconn *conn,
                      const char *command,
                      int nParams,
                      const Oid *paramTypes,
                      const char * const *paramValues,
                      const int *paramLengths,
                      const int *paramFormats,
                      int resultFormat);

Данная функция эквивалентна функции PQsendQuery за тем исключением, что параметры запроса могут быть указаны отдельно от самой строки запроса. Параметры функции обрабатываются так же, как и в функции PQexecParams. Как и функция PQexecParams, она допускает наличие только одной команды в строке запроса.

Отправляет запрос на создание подготовленного оператора с заданными параметры без ожидания завершения операции.

int PQsendPrepare(тип PGconn *объект conn,
                  const char *stmtName,
                  const char *query,
                  int nParams,
                  const тип Oid *paramTypes);

Данная функция является асинхронной версией функции PQprepare: она возвращает 1, если запрос был успешно отправлен, и 0 — в противном случае. После успешного вызова необходимо вызвать функцию PQgetResult для чтобы определить, был ли сервером успешно создан подготовленный оператор. Параметры данной функции обрабатываются так же, как и в функции PQprepare.

Отправляет запрос на выполнение подготовленного оператора с заданными параметры без ожидания получения результатов.

int PQsendQueryPrepared(тип PGconn *объект conn,
                        const char *stmtName,
                        int nParams,
                        const char * const *paramValues,
                        const int *paramLengths,
                        const int *paramFormats,
                        int resultFormat);

Данная функция аналогична функции PQsendQueryParams, однако выполняемая команда определяется путём указания имени ранее подготовленного оператора вместо передачи строки запроса. Параметры функции обрабатываются так же, как и в функции PQexecPrepared.

Отправляет запрос на получение информации об указанном подготовленного оператора без ожидания завершения.

int PQsendDescribePrepared(PGconn *conn, const char *stmtName);

Данная функция является асинхронной версией функции PQdescribePrepared: в случае успешной отправки запроса функция возвращает 1, а в противном случае — 0. После успешного вызова необходимо вызвать функцию PQgetResult для получения результатов. Параметры данной функции обрабатываются идентично параметрам PQdescribePrepared.

Отправляет запрос на получение информации об указанном портала без ожидания завершения.

int PQsendDescribePortal(PGconn *conn, const char *portalName);

Данная функция является асинхронной версией функции PQdescribePortal: в случае успешной отправки запроса функция возвращает 1, а в противном случае — 0. После успешного вызова необходимо вызвать функцию PQgetResult для получения результатов. Параметры данной функции обрабатываются идентично параметрам PQdescribePortal.

Отправляет запрос на закрытие указанного подготовленного оператора без ожидания завершения.

int PQsendClosePrepared(PGconn *conn, const char *stmtName);

Данная функция является асинхронной версией функции PQclosePrepared: в случае успешной отправки запроса функция возвращает 1, а в противном случае — 0. После успешного вызова необходимо вызвать функцию PQgetResult для получения результатов. Параметры данной функции обрабатываются идентично параметрам PQclosePrepared.

Отправляет запрос на закрытие указанного портала без ожидания завершения.

int PQsendClosePortal(PGconn *conn, const char *portalName);

Данная функция является асинхронной версией функции PQclosePortal: в случае успешной отправки запроса функция возвращает 1, а в противном случае — 0. После успешного вызова необходимо вызвать функцию PQgetResult для получения результатов. Параметры данной функции обрабатываются идентично параметрам PQclosePortal.

Функция ожидает получения следующего результата предыдущего PQsendQuery, PQsendQueryParams, PQsendPrepare, PQsendQueryPrepared, PQsendDescribePrepared, PQsendDescribePortal, PQsendClosePrepared, PQsendClosePortal, PQsendPipelineSync, или PQpipelineSync вызова и возвращает его. Когда выполнение команды завершено и новых результатов не ожидается, возвращается значение NULL.

PGresult *PQgetResult(PGconn *conn);

PQgetResult Функцию необходимо вызывать многократно до тех пор, пока она не вернет значение NULL, что указывает на завершение команды. (Если функция вызывается при отсутствии активной команды, PQgetResult будет сразу возвращено значение NULL.) Каждый результат функции, отличный от значение NULL, PQgetResult следует обработать с помощью тех же самых PGresult функций доступа, которые были описаны ранее. Не забудьте освободить каждый объект результата с помощью функции PQclear после завершения работы с ним. Обратите внимание, что функция PQgetResult блокируется только в том случае, если команда активна, а необходимые данные ответа еще не были прочитаны функцией PQconsumeInput .

В режиме конвейерной обработки PQgetResult управление возвращается в обычном режиме, если не возникнет ошибка; для любого последующего запроса, отправленного после того, который вызвал ошибку, вплоть до следующей точки синхронизации (не включая её), специальный результат типа PGRES_PIPELINE_ABORTED будет будет возвращен, а следом за ним — значение NULL. При достижении точки синхронизации конвейера будет возвращен результат типа PGRES_PIPELINE_SYNC will be returned. Результат следующего после точки синхронизации запроса следует незамедлительно (то есть после точки синхронизации значение NULL не возвращается).

Если от сервера поступили входные данные, они считываются.

int PQconsumeInput(PGconn *conn);

PQconsumeInput обычно возвращает 1, что указывает на «ошибок нет», но возвращает 0, если возникла какая-либо ошибка (в этом случае следует обратиться к PQerrorMessage могут быть ). Обратите внимание, что результат не указывает на то, были ли фактически получены какие-либо входные данные. После вызова функции PQconsumeInput приложение может проверить PQisBusy и/или функцию PQnotifies , чтобы определить, изменилось ли их состояние.

PQconsumeInput можно вызывать даже в том случае, если приложение еще не готово к обработке результата или уведомления . Данная функция прочитает доступные данные и сохранит их в буфере, тем самым устраняя select() признак готовности к чтению. Таким образом, приложение может использовать функцию PQconsumeInput для немедленного сброса select() состояния готовности, а затем проверить результаты в свободном режиме.

Данная функция возвращает 1, если команда занята, то есть, PQgetResult если выполнение приведет к блокировке в ожидании ввода. Возвращаемое значение 0 указывает на то, что функция PQgetResult могут быть может быть вызвана с гарантией отсутствия блокировки.

int PQisBusy(тип PGconn *объект conn);

PQisBusy не выполняет попыток самостоятельного чтения данных с сервера; следовательно, функция PQconsumeInput должна быть вызвана первой, иначе состояние занятости никогда не завершится.

Устанавливает для соединения неблокирующий статус.

int PQsetnonblocking(PGconn *conn, int arg);

Переводит соединение в неблокирующий режим, если arg имеет значение 1, или в блокирующий режим, если значение arg равно 0. Функция возвращает 0 в случае успеха и -1 при возникновении ошибки.

В неблокирующем состоянии успешные вызовы функций PQsendQuery, PQputline, PQputnbytes, PQputCopyData, и PQendcopy не будут приводить к блокировке; вносимые ими изменения сохраняются в локальном выходном буфере до момента их отправки. В случае неудачного вызова возвращается ошибка, после чего попытку необходимо повторить.

Обратите внимание, что функция PQexec не учитывает неблокирующий режим; при вызове она в любом случае будет работать в блокирующем режиме.

Возвращает статус блокировки для соединения с базой данных.

int PQisnonblocking(const PGconn *conn);

Возвращает 1, если для соединения установлен неблокирующий режим, и 0, если режим соединения — блокирующий.

Выполняет попытку сброса любых поставленных в очередь выходных данных на сервер. Функция возвращает 0 в случае успеха (или если очередь отправки пуста), -1 в случае возникновения ошибки или 1, если пока не удалось отправить все данные из очереди отправки (данный случай возможен только в том случае, если соединение является неблокирующим).

int PQflush(PGconn *conn);