Ruta Rápida

PostgreSQL proporciona un interfaz rápido para enviar llamadas de función al servidor. Esta es una puerta falsa en la interioridades del sistema, y puede suponer un agujero de seguridad. La mayoría de los usuario no necesitarán esta carácterística.

• PQfn Requiere la ejecución de una función de servidor a través del interfaz de ruta rápida.

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

  El argumento fnid es el identificador del objeto de la función que se debe ejecutar. result_buf es la zona de almacenamiento en la cual se debe situar el valor devuelto. El programa que hace la llamade deberá haber reservado suficiente espacio para almacenar el valor devuelto (¡no se comprueba!). La longitud del resultado real se devolverá en el entero apuntado por result_len. Si se espera un resultado entero de 4 bytes, fije result_is_int a 1; de otra forma, fíjelo a 0. (Fijando result_is_int a 1 se indica a libpq que administre el valor balanceando los bytes si es necesario, de forma que se envíe un valor int adecuado a la máquina cliente. Cuando result_is_int es 0, la cadena de bytes enviada por el servidor se devuelve sin modificar). args y nargs especifican los argumentos a pasar a la función.

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

  PQfn siempre devuelve un PGresult* válido. Se debería comprobar el valor de resultStatus antes de utilizar el resultado. El programa que hace la llamada es responsable de liberar el PGresult con PQclear cuando ya no lo necesite.