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

PGresult *PQexec(PGconn *conn, const char *command);

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

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

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

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

Аргументы функции:

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

PGresult *PQprepare(PGconn *conn,
                    const char *stmtName,
                    const char *query,
                    int nParams,
                    const Oid *paramTypes);

PQprepare создает подготовленный оператор для последующего выполнения с помощью PQexecPrepared. Эта функция позволяет выполнять команды повторно без их повторного разбора и планирования каждый раз; см. PREPARE для получения подробной информации.

Функция создает подготовленный оператор с именем stmtName из строки query, которая должна содержать одну SQL-команду. stmtName может быть "", чтобы создать безымянное выражение, в этом случае любое существующее безымянное выражение автоматически заменяется; в противном случае, если имя выражения уже определено в текущей сессии, это является ошибкой. Если используются параметры, они обозначаются в запросе как $1, $2 и т. д. nParams - это количество параметров, для которых типы предопределены в массиве paramTypes[]. (Указатель на массив может быть NULL, когда nParams равно нулю). paramTypes[] указывает, по OID, типы данных, которые должны быть назначены символам параметров. Если paramTypes равно NULL, или любой элемент массива равен нулю, сервер назначает тип данных символу параметра так же, как он делает это для неопределенной литеральной строки. Кроме того, запрос может использовать символы параметров с номерами, превышающими nParams; типы данных будут также выводиться для этих символов. (См. PQdescribePrepared для способа узнать, какие типы данных были выведены).

Как и с PQexec, результатом обычно является объект PGresult, содержимое которого указывает на успешное или неудачное выполнение на стороне сервера. Пустой результат указывает на нехватку памяти или невозможность отправить команду вообще. Используйте PQerrorMessage для получения дополнительной информации об ошибках такого рода.

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

PGresult *PQexecPrepared(PGconn *conn,
                         const char *stmtName,
                         int nParams,
                         const char * const *paramValues,
                         const int *paramLengths,
                         const int *paramFormats,
                         int resultFormat);

PQexecPrepared похож на PQexecParams, но команда для выполнения указывается путем указания ранее подготовленного оператора, а не строки запроса. Эта функция позволяет выполнять команды, которые будут использоваться повторно, разбирать и планировать только один раз, а не каждый раз при их выполнении. Оператор должен быть предварительно подготовлен в текущей сессии.

Все параметры идентичны PQexecParams, за исключением того, что вместо строки запроса указывается имя подготовленного оператора, и параметр paramTypes[] отсутствует (он не нужен, так как типы параметров подготовленного оператора были определены при его создании).

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

PGresult *PQdescribePrepared(PGconn *conn, const char *stmtName);

PQdescribePrepared позволяет приложению получить информацию о ранее подготовленном операторе.

stmtName может быть "" или NULL для ссылки на безымянный оператор, в противном случае он должен быть именем существующего подготовленного оператора. При успешном выполнении возвращается PGresult со статусом PGRES_COMMAND_OK. Функции PQnparams и PQparamtype могут быть применены к этому PGresult для получения информации о параметрах подготовленного оператора, а функции PQnfields, PQfname, PQftype и т. д. предоставляют информацию о столбцах результата (если они есть) оператора.

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

PGresult *PQdescribePortal(PGconn *conn, const char *portalName);

PQdescribePortal позволяет приложению получить информацию о ранее созданном портале. (libpq не предоставляет прямого доступа к порталам, но вы можете использовать эту функцию для изучения свойств курсора, созданного с помощью SQL-команды DECLARE CURSOR).

portalName может быть "" или NULL для ссылки на безымянный портал, в противном случае это должно быть имя существующего портала. При успешном выполнении возвращается PGresult со статусом PGRES_COMMAND_OK. Функции PQnfields, PQfname, PQftype и т. д. могут быть применены к PGresult для получения информации о столбцах результата (если они есть) портала.

Возвращает статус выполнения команды.

ExecStatusType PQresultStatus(const PGresult *res);

PQresultStatus может возвращать одно из следующих значений:

Если статус результата равен PGRES_TUPLES_OK или PGRES_SINGLE_TUPLE, то нижеописанные функции могут быть использованы для получения строк, возвращенных запросом. Обратите внимание, что команда SELECT, которая случайно получает ноль строк, все равно показывает PGRES_TUPLES_OK. PGRES_COMMAND_OK предназначен для команд, которые никогда не могут возвращать строки (INSERT или UPDATE без предложения RETURNING, и т.д.). Ответ PGRES_EMPTY_QUERY может указывать на ошибку в клиентском программном обеспечении.

Результат со статусом PGRES_NONFATAL_ERROR никогда не будет возвращаться непосредственно функцией PQexec или другими функциями выполнения запросов; результаты этого типа вместо этого передаются обработчику уведомлений (см. Раздел 31.13).

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

char *PQresStatus(ExecStatusType status);

Возвращает сообщение об ошибке, связанное с командой, или пустую строку, если ошибки не было.

char *PQresultErrorMessage(const PGresult *res);

Если произошла ошибка, возвращаемая строка будет содержать завершающий символ перехода строки. Вызывающая сторона не должна освобождать результат напрямую. Он будет освобожден, когда связанная структура PGresult будет передана в PQclear.

Сразу после вызова PQexec или PQgetResult, PQerrorMessage (на соединении) вернет тот же самый текст, что и PQresultErrorMessage (на результате). Однако, PGresult будет сохранять свое сообщение об ошибке до уничтожения, в то время как сообщение об ошибке соединения изменится при выполнении последующих операций. Используйте PQresultErrorMessage когда вам нужно знать статус, связанный с конкретным PGresult; используйте PQerrorMessage когда вам нужно знать статус последней операции на соединении.

Возвращает отформатированную версию сообщения об ошибке, связанную с объектом PGresult.

char *PQresultVerboseErrorMessage(const PGresult *res,
                                  PGVerbosity verbosity,
                                  PGContextVisibility show_context);

В некоторых ситуациях клиент может захотеть получить более подробную версию ранее сообщенной ошибки. PQresultVerboseErrorMessage решает эту проблему, вычисляя сообщение, которое было бы сгенерировано PQresultErrorMessage, если бы указанные настройки детальности сообщения были включены для соединения при создании данного PGresult. Если PGresult не является ошибочным результатом, вместо этого будет сообщено “PGresult не является ошибочным результатом”. Возвращаемая строка включает завершающий символ перехода строки.

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

Возможно возвращение NULL, если недостаточно памяти.

Возвращает отдельное поле отчета об ошибке.

char *PQresultErrorField(const PGresult *res, int fieldcode);

fieldcode - это идентификатор поля ошибки; см. перечисленные ниже символы. NULL возвращается, если PGresult не является результатом ошибки или предупреждения, или не содержит указанное поле. Значения полей обычно не содержат завершающего символа перехода строки. Вызывающая сторона не должна освобождать результат напрямую. Он будет освобожден, когда связанный с ним PGresult передается в PQclear.

Доступны следующие коды полей:

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

Внутренние ошибки, генерируемые libpq, обычно содержат только уровень серьезности и основное сообщение, без других полей.

Обратите внимание, что поля ошибок доступны только из объектов PGresult, а не из объектов PGconn; функция PQerrorField отсутствует.

Освобождает память, связанную с PGresult. Каждый результат команды должен быть освобожден с помощью PQclear, когда он больше не нужен.

void PQclear(PGresult *res);

Если аргумент является указателем на NULL, операция не выполняется.

Вы можете сохранить объект PGresult на протяжении всего времени его использования; он не исчезает при выполнении новой команды или даже при закрытии соединения. Чтобы избавиться от него, необходимо вызвать функцию PQclear. Если этого не сделать, это может привести к утечкам памяти в вашем приложении.

Возвращает количество строк (кортежей) в результате запроса. (Обратите внимание, что объекты PGresult ограничены не более чем INT_MAX строками, поэтому достаточно int результата).

int PQntuples(const PGresult *res);

Возвращает количество столбцов (полей) в каждой строке результата запроса.

int PQnfields(const PGresult *res);

Возвращает имя столбца, связанное с заданным номером столбца. Номера столбцов начинаются с 0. Вызывающая сторона не должна освобождать результат напрямую. Он будет освобожден, когда связанный PGresult обработчик будет передан PQclear.

char *PQfname(const PGresult *res,
              int column_number);

Возвращается значение NULL, если номер столбца выходит за пределы диапазона.

Возвращает номер столбца, связанный с заданным именем столбца.

int PQfnumber(const PGresult *res,
              const char *column_name);

-1 возвращается, если указанное имя не соответствует ни одному столбцу.

Данное имя рассматривается как идентификатор в SQL-команде, то есть оно приводится к нижнему регистру, если не заключено в двойные кавычки. Например, если имеется результат запроса, сгенерированного из SQL-команды:

SELECT 1 AS FOO, 2 AS "BAR";

у нас были бы результаты:

PQfname(res, 0)              foo
PQfname(res, 1)              BAR
PQfnumber(res, "FOO")        0
PQfnumber(res, "foo")        0
PQfnumber(res, "BAR")        -1
PQfnumber(res, "\"BAR\"")    1

Возвращает OID таблицы, из которой был получен указанный столбец. Номера столбцов начинаются с 0.

Oid PQftable(const PGresult *res,
             int column_number);

Возвращается InvalidOid, если номер столбца выходит за пределы диапазона или если указанный столбец не является простым ссылкой на столбец таблицы. Можно выполнить запрос к системной таблице pg_class, чтобы определить, на какую именно таблицу есть ссылка.

Тип Oid и константа InvalidOid будут определены при включении заголовочного файла libpq. Оба они будут некоторым целочисленным типом.

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

int PQftablecol(const PGresult *res,
                int column_number);

Если номер столбца выходит за пределы диапазона или указанный столбец не является простым ссылкой на столбец таблицы, возвращается ноль.

Возвращает код формата, указывающий формат данного столбца. Номера столбцов начинаются с 0.

int PQfformat(const PGresult *res,
              int column_number);

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

Возвращает тип данных, связанный с заданным номером столбца. Возвращаемое целое число является внутренним идентификатором типа. Номера столбцов начинаются с 0.

Oid PQftype(const PGresult *res,
            int column_number);

Вы можете запросить системную таблицу pg_type, чтобы получить имена и свойства различных типов данных. OID встроенных типов данных определены в файле catalog/pg_type_d.h в каталоге include установки Tantor SE-1C.

Возвращает модификатор типа столбца, связанного с заданным номером столбца. Номера столбцов начинаются с 0.

int PQfmod(const PGresult *res,
           int column_number);

Интерпретация значений модификатора зависит от типа данных; обычно они указывают на точность или ограничения размера. Значение -1 используется для обозначения “отсутствия доступной информации”. Большинство типов данных не используют модификаторы, в таком случае значение всегда равно -1.

Возвращает размер в байтах столбца, связанного с заданным номером столбца. Номера столбцов начинаются с 0.

int PQfsize(const PGresult *res,
            int column_number);

PQfsize возвращает выделенное пространство для этого столбца в строке базы данных, другими словами, размер внутреннего представления данных сервера. (Соответственно, это не очень полезно для клиентов). Отрицательное значение указывает на то, что тип данных имеет переменную длину.

Возвращает 1, если PGresult содержит двоичные данные, и 0, если он содержит текстовые данные.

int PQbinaryTuples(const PGresult *res);

Эта функция устарела (за исключением ее использования в связи с COPY), потому что в одном PGresult может содержаться текстовые данные в некоторых столбцах и двоичные данные в других. PQfformat предпочтительнее. PQbinaryTuples возвращает 1 только если все столбцы результата являются двоичными (формат 1).

Возвращает одно значение поля одной строки PGresult. Номера строки и столбца начинаются с 0. Вызывающая сторона не должна освобождать результат напрямую. Он будет освобожден, когда связанный дескриптор PGresult будет передан в PQclear.

char *PQgetvalue(const PGresult *res,
                 int row_number,
                 int column_number);

Для данных в текстовом формате, значение, возвращаемое функцией PQgetvalue, является нуль-терминированной строкой, представляющей значение поля. Для данных в бинарном формате, значение представлено в бинарном представлении, определенном функциями typsend и typreceive типа данных. (В этом случае значение фактически следует за нулевым байтом, но это обычно не полезно, так как значение может содержать встроенные нули).

Возвращается пустая строка, если значение поля равно null. См. PQgetisnull для различия между значениями null и пустыми строками.

Указатель, возвращаемый функцией PQgetvalue, указывает на хранилище, которое является частью структуры PGresult. Нельзя изменять данные, на которые он указывает, и необходимо явно скопировать данные в другое хранилище, если они должны использоваться после завершения существования структуры PGresult самой по себе.

Проверяет поле на наличие значения NULL. Номера строки и столбца начинаются с 0.

int PQgetisnull(const PGresult *res,
                int row_number,
                int column_number);

Эта функция возвращает 1, если поле является пустым (null), и 0, если оно содержит значение not-null. (Обратите внимание, что PQgetvalue вернет пустую строку, а не нулевой указатель, для пустого поля).

Возвращает фактическую длину значения поля в байтах. Номера строки и столбца начинаются с 0.

int PQgetlength(const PGresult *res,
                int row_number,
                int column_number);

Это фактическая длина данных для конкретного значения данных, то есть размер объекта, на который указывает PQgetvalue. Для формата текстовых данных это то же самое, что и strlen(). Для бинарного формата это существенная информация. Обратите внимание, что нельзя полагаться на PQfsize для получения фактической длины данных.

Возвращает количество параметров подготовленного оператора.

int PQnparams(const PGresult *res);

Эта функция полезна только при проверке результата PQdescribePrepared. Для других типов результатов она вернет ноль.

Возвращает тип данных указанного параметра оператора. Номера параметров начинаются с 0.

Oid PQparamtype(const PGresult *res, int param_number);

Эта функция полезна только при проверке результата PQdescribePrepared. Для других типов результатов она вернет ноль.

Выводит все строки и, при необходимости, имена столбцов в указанный поток вывода.

void PQprint(FILE *fout,      /* output stream */
             const PGresult *res,
             const PQprintOpt *po);
typedef struct
{
    pqbool  header;      /* print output field headings and row count */
    pqbool  align;       /* fill align the fields */
    pqbool  standard;    /* old brain dead format */
    pqbool  html3;       /* output HTML tables */
    pqbool  expanded;    /* expand tables */
    pqbool  pager;       /* use pager for output if needed */
    char    *fieldSep;   /* field separator */
    char    *tableOpt;   /* attributes for HTML table element */
    char    *caption;    /* HTML table caption */
    char    **fieldName; /* null-terminated array of replacement field names */
} PQprintOpt;

Эта функция ранее использовалась приложением psql для печати результатов запросов, но это уже не так. Обратите внимание, что она предполагает, что все данные находятся в текстовом формате.

Возвращает тег статуса команды из SQL-команды, которая сгенерировала PGresult.

char *PQcmdStatus(PGresult *res);

Обычно это просто имя команды, но оно может включать дополнительные данные, такие как количество обработанных строк. Вызывающая сторона не должна освобождать результат напрямую. Он будет освобожден, когда связанный с ним дескриптор PGresult будет передан в PQclear.

Возвращает количество строк, затронутых SQL-командой.

char *PQcmdTuples(PGresult *res);

Эта функция возвращает строку, содержащую количество строк, затронутых SQL оператором, который сгенерировал PGresult. Эта функция может быть использована только после выполнения оператора SELECT, CREATE TABLE AS, INSERT, UPDATE, DELETE, MERGE, MOVE, FETCH, или COPY, или выполнения EXECUTE подготовленного запроса, содержащего оператор INSERT, UPDATE, DELETE, или MERGE. Если команда, которая сгенерировала PGresult, была чем-то другим, PQcmdTuples возвращает пустую строку. Вызывающая сторона не должна освобождать возвращаемое значение напрямую. Оно будет освобождено, когда связанный дескриптор PGresult будет передан в PQclear.

Возвращает OID вставленной строки, если команда SQL была INSERT, которая вставила ровно одну строку в таблицу, имеющую OID, или EXECUTE подготовленного запроса, содержащего подходящий оператор INSERT. В противном случае, эта функция возвращает InvalidOid. Эта функция также вернет InvalidOid, если таблица, затронутая оператором INSERT, не содержит OID.

Oid PQoidValue(const PGresult *res);

Эта функция устарела в пользу PQoidValue, и не является потокобезопасной. Она возвращает строку с OID вставленной строки, в то время как PQoidValue возвращает значение OID.

char *PQoidStatus(const PGresult *res);

char *PQescapeLiteral(PGconn *conn, const char *str, size_t length);

PQescapeLiteral экранирует строку для использования внутри SQL-команды. Это полезно при вставке значений данных в виде литеральных констант в SQL-команды. Некоторые символы (такие как кавычки и обратные косые черты) должны быть экранированы, чтобы предотвратить их специальную интерпретацию SQL-парсером. PQescapeLiteral выполняет эту операцию.

PQescapeLiteral возвращает экранированную версию параметра str в памяти, выделенной с помощью malloc(). Эту память следует освободить с помощью PQfreemem(), когда результат больше не нужен. Завершающий нулевой байт не требуется и не должен учитываться в параметре length. (Если завершающий нулевой байт найден до обработки length байтов, PQescapeLiteral останавливается на нуле; поведение похоже на strncpy). Возвращаемая строка заменяет все специальные символы, чтобы их можно было правильно обработать парсером строковых литералов Tantor SE-1C. Также добавляется завершающий нулевой байт. Апострофы которые должны окружать строковые литералы Tantor SE-1C, включены в результирующую строку.

При возникновении ошибки, PQescapeLiteral возвращает NULL, а соответствующее сообщение сохраняется в объекте conn.

Обратите внимание, что необходимо и неправильно экранировать данные, когда значение передается в качестве отдельного параметра в PQexecParams или его аналогичные процедуры.

char *PQescapeIdentifier(PGconn *conn, const char *str, size_t length);

PQescapeIdentifier экранирует строку для использования в качестве SQL идентификатора, такого как имя таблицы, столбца или функции. Это полезно, когда пользовательский идентификатор может содержать специальные символы, которые иначе не будут интерпретироваться как часть идентификатора SQL-парсером, или когда идентификатор может содержать символы верхнего регистра, чей регистр должен быть сохранен.

PQescapeIdentifier возвращает версию параметра str, экранированную в качестве идентификатора SQL в памяти, выделенной с помощью malloc(). Эта память должна быть освобождена с помощью PQfreemem(), когда результат больше не нужен. Завершающий нулевой байт не требуется и не должен учитываться в length. (Если завершающий нулевой байт найден до обработки length байтов, PQescapeIdentifier останавливается на нуле; поведение похоже на strncpy). Возвращаемая строка заменяет все специальные символы, чтобы она была правильно обработана как идентификатор SQL. Также добавляется завершающий нулевой байт. Возвращаемая строка также будет окружена двойными кавычками.

При возникновении ошибки, PQescapeIdentifier возвращает NULL, а соответствующее сообщение сохраняется в объекте conn.

size_t PQescapeStringConn(PGconn *conn,
                          char *to, const char *from, size_t length,
                          int *error);

PQescapeStringConn экранирует строковые литералы, подобно PQescapeLiteral. В отличие от PQescapeLiteral, вызывающая сторона должна предоставить буфер соответствующего размера. Кроме того, PQescapeStringConn не генерирует апострофы, которые должны окружать строковые литералы Tantor SE-1C; они должны быть предоставлены в SQL-команде, в которую будет вставлен результат. Параметр from указывает на первый символ строки, который должен быть экранирован, а параметр length указывает количество байтов в этой строке. Завершающий нулевой байт не требуется и не должен учитываться в length. (Если завершающий нулевой байт найден до обработки length байтов, PQescapeStringConn останавливается на нуле; поведение похоже на strncpy). Параметр to должен указывать на буфер, который может вместить как минимум на один байт больше, чем двойное значение length, в противном случае поведение не определено. Поведение также не определено, если строки to и from перекрываются.

Если параметр error не равен NULL, то *error устанавливается в ноль в случае успеха и в ненулевое значение в случае ошибки. В настоящее время единственные возможные условия ошибки связаны с недопустимой многобайтовой кодировкой в исходной строке. Выходная строка все равно генерируется при ошибке, но можно ожидать, что сервер отклонит ее как некорректную. При ошибке подходящее сообщение сохраняется в объекте conn, независимо от того, является ли error равным NULL.

PQescapeStringConn возвращает количество записанных байтов в to, не включая завершающий нулевой байт.

PQescapeString - это старая, устаревшая версия функции PQescapeStringConn.

size_t PQescapeString (char *to, const char *from, size_t length);

Разница между PQescapeStringConn и PQescapeString заключается только в том, что PQescapeString не принимает параметры PGconn или error. Из-за этого он не может настраивать свое поведение в зависимости от свойств соединения (например, кодировки символов) и, следовательно, может давать неправильные результаты. Кроме того, у него нет способа сообщать об ошибках.

PQescapeString можно безопасно использовать в клиентских программах, которые работают только с одним соединением Tantor SE-1C за раз (в этом случае она может узнать, что ей нужно знать “за кулисами”). В других контекстах это представляет угрозу безопасности и следует избегать в пользу PQescapeStringConn.

Экранирует двоичные данные для использования внутри SQL-команды с типом bytea. Как и в случае с PQescapeStringConn, это используется только при вставке данных непосредственно в строку SQL-команды.

unsigned char *PQescapeByteaConn(PGconn *conn,
                                 const unsigned char *from,
                                 size_t from_length,
                                 size_t *to_length);

Некоторые значения байтов должны быть экранированы при использовании в качестве части литерала типа bytea в операторе SQL. PQescapeByteaConn экранирует байты с использованием либо шестнадцатеричного кодирования, либо экранирования обратной косой чертой. См. Раздел 8.4 для получения дополнительной информации.

Параметр from указывает на первый байт строки, который должен быть экранирован, а параметр from_length указывает количество байтов в этой двоичной строке. (Завершающий нулевой байт не является необходимым и не учитывается). Параметр to_length указывает на переменную, которая будет содержать длину результирующей экранированной строки. Длина этой строки включает завершающий нулевой байт результата.

PQescapeByteaConn возвращает экранированную версию двоичной строки параметра from в памяти, выделенной с помощью функции malloc(). Эта память должна быть освобождена с помощью функции PQfreemem(), когда результат больше не нужен. Возвращаемая строка имеет все специальные символы заменены, чтобы их можно было правильно обработать парсером строковых литералов Tantor SE-1C и функцией ввода bytea. Также добавляется завершающий нулевой байт. Апострофы, в которые заключают строковые литералы Tantor SE-1C, не являются частью результирующей строки.

При ошибке возвращается нулевой указатель, а соответствующее сообщение об ошибке сохраняется в объекте conn. В настоящее время единственная возможная ошибка - недостаток памяти для строки результата.

PQescapeBytea - это старая, устаревшая версия функции PQescapeByteaConn.

unsigned char *PQescapeBytea(const unsigned char *from,
                             size_t from_length,
                             size_t *to_length);

Разница между PQescapeByteaConn и PQescapeBytea заключается только в том, что PQescapeBytea не принимает параметр PGconn. Из-за этого PQescapeBytea может быть безопасно использован только в клиентских программах, которые используют одно соединение Tantor SE-1C за раз (в этом случае она может узнать все, что ей нужно “за кулисами”). Однако, если она используется в программах, которые используют несколько соединений с базой данных, она может дать неправильные результаты (в таких случаях следует использовать PQescapeByteaConn).

Преобразует строковое представление двоичных данных в двоичные данные - обратное действие к PQescapeBytea. Это необходимо при получении данных типа bytea в текстовом формате, но не при получении их в двоичном формате.

unsigned char *PQunescapeBytea(const unsigned char *from, size_t *to_length);

Параметр from указывает на строку, такую как может быть возвращена PQgetvalue, когда применяется к столбцу bytea. PQunescapeBytea преобразует эту строковую представление в двоичное представление. Он возвращает указатель на буфер, выделенный с помощью malloc(), или NULL в случае ошибки, и помещает размер буфера в to_length. Результат должен быть освобожден с помощью PQfreemem, когда он больше не нужен.

Это преобразование не является точной обратной операцией для PQescapeBytea, потому что строка не ожидается быть “экранированной” при получении из PQgetvalue. В частности, это означает, что нет необходимости учитывать экранирование строк, и, следовательно, нет необходимости в параметре PGconn.