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

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

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

В режиме конвейера эта функция запрещена.

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

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.

Ожидает следующий результат от предыдущего вызова PQsendQuery, PQsendQueryParams, PQsendPrepare, PQsendQueryPrepared, PQsendDescribePrepared, PQsendDescribePortal или PQpipelineSync и возвращает его. Возвращается нулевой указатель, когда команда завершена и больше не будет результатов.

PGresult *PQgetResult(PGconn *conn);

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

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

Если входные данные доступны с сервера, их следует обработать.

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);