1.5. 捷径接口

PostgreSQL 提供一个发往后端的函数调用的捷径接口． 这是一个通向系统内部的后门，因而可能存在安全漏洞． 大多数用户应该不需要这个特性．

• PQfn 请求允许通过捷径接口执行后端函数．

  PGresult* PQfn(PGconn* conn,
                 int fnid,
                 int *result_buf,
                 int *result_len,
                 int result_is_int,
                 const PQArgBlock *args,
                 int nargs);

  fnid参数是待执行的函数的对象标识（OID）． result_buf是放置返回值的缓冲区． 调用者必须为返回值分配足够的空间（这里没有检查！）． 实际的返回值长度将被放在result_len指向的整数里返回． 如果预期返回值是 4-字节整数，把result_is_int设为 1； 否则设为 0．（把result_is_int设为 1 告诉 libpq必要时交换数值字节序， 这样就可以正确地传输成客户机上的整数值．当 result_is_int是 0 时， 后端发送回来的字节串不做修改．） args和nargs声明要传入函数的参数．

  typedef struct {
      int len;
      int isint;
      union {
          int *ptr;
          int integer;
      } u;
  } PQArgBlock;

  PQfn 总是返回一个有效的PGresult*． 在使用结果之前应该检查结果状态。 当结果不再使用后，调用者有义务使用 PQclear 释放PGresult．