1.libpq简述
libpq是postgres提供的C接口函数库,允许客户端程序向postgres数据库服务器发送查询请求并返回查询结果。
2.libpq使用前准备
使用libpq的程序必须包含“libpq-fe.h”头文件,并链接libpq.lib库文件。
3.libpq常用函数说明
3.1 数据库连接函数
3.1.1 PQconnectdb 与数据库服务器建立一个新的连接
函数原型:PGconn* PQconnectdb(const char* conninfo);
参数说明:conninfo是一个用于描述数据库连接参数的字符串(以空格为分隔符),例如:“hostaddr=192.168.1.2 port=5432 dbname=mydb user=postgres password=mypass”.其中常用关键字有host,hostaddr,port,dbname,user,password,sslmode等
返回值: PGconn是一个用于记录postgres连接状态的指针。函数成功执行时返回一个非空的指针,并可以使用PQstatus函数查询连接是否成功。
3.1.2 PQfinish 关闭与数据库服务器的连接,并释放PGconn的内存
函数原型: void PQfinish(PGconn* conn);
说明:即使数据库连接失败,也要调用PQfinish函数以释放PGconn的内存;PQfinish调用之后不能再使用PGconn对象。
3.2 连接状态函数
3.2.1 PQstatus 返回连接状态
函数原型: ConnStatusType PQstatus(const PGconn* conn);
返回值: ConnStatusType