https://github.com/ibarwick/libfq

A wrapper library for Firebird's C API, loosely based on PostgreSQL's libpq.
https://github.com/ibarwick/libfq

firebird libfq

Last synced: about 1 year ago
JSON representation

A wrapper library for Firebird's C API, loosely based on PostgreSQL's libpq.

• Host: GitHub
• URL: https://github.com/ibarwick/libfq
• Owner: ibarwick
• Created: 2013-12-23T01:48:18.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2025-04-18T10:03:43.000Z (over 1 year ago)
• Last Synced: 2025-04-18T23:12:00.767Z (over 1 year ago)
• Topics: firebird, libfq
• Language: Shell
• Homepage: https://libfq.sql-info.de/
• Size: 1.32 MB
• Stars: 9
• Watchers: 3
• Forks: 2
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG

Awesome Lists containing this project

README

          
libfq - C API wrapper for Firebird

==================================

`libfq` provides a number of functions which act as convenience

wrappers around the native Firebird C API, which is cumbersome to use.

It is loosely based on PostgreSQL's `libpq` and provides a subset of

that API's functions - names beginning with `FQ` rather than `PQ` -

with more-or-less identical function signatures.

It also provides some Firebird-specific functions.

While basically functional, `libfq` is still work-in-progress and

the API definitions may change between releases in an incompatible way.

*USE AT YOUR OWN RISK*.

Requirements and compatibility

------------------------------

`libfq` should work on any reasonably POSIX-like system; see the

[INSTALL.md](INSTALL.md) file for details.

It has been developed against Firebird 3 ~ Firebird 5, and should

work with Firebird 2.5 and later.

Installation

------------

RPM packages for CentOS and derivatives, and current Fedora versions, are

available via the Fedora "copr" build system; for details see here:

For installation from source, see file [INSTALL.md](INSTALL.md).

Documentation

-------------

`sgml` documentation is available in the `doc` subdirectory and can be built

with the `Makefile` contained therein.

An online version of the documentation is available here: [libfq documentation](https://libfq.sql-info.de/)

Applications

------------

Following applications make use of `libfq`:

- [firebird_fdw](https://github.com/ibarwick/firebird_fdw) - a foreign data wrapper for PostgreSQL

- [fbsql](https://github.com/ibarwick/fbsql) - a command-line client inspired by PostgreSQL's `psql`

KNOWN ISSUES

------------

* Data types

  - `BLOB` (other than `SUB_TYPE TEXT`) not supported

  - `ARRAY` datatype currently not handled

* Parameterized queries (function `FQexecParams()`):

  - `NUMERIC`/`DECIMAL`: may overflow if more digits than permitted are supplied