PQconnectdbParams

功能描述

与数据库服务器建立一个新的连接。

原型

  1. PGconn *PQconnectdbParams(const char * const *keywords,
  2.                           const char * const *values,
  3.                           int expand_dbname);

参数

表 1 PQconnectdbParams参数

关键字

参数说明

keywords

定义为一个字符串的数组，每个都成为一个关键字。

values

给每个关键字一个值。

expand_dbname

当expand_dbname是非零的时，允许将dbname的关键字值看做一个连接字符串。只有第一个出现的dbname是这样展开的，任何随后的dbname值作为纯数据库名处理。

返回值

PGconn *：指向包含链接的对象指针，内存在函数内部申请。

注意事项

这个函数用从两个NULL结束的数组中来的参数打开一个新的数据库连接。与PQsetdbLogin不同的是，可以不必更换函数签名（名字）就可以扩展参数集，所以建议应用程序中使用这个函数（或者它的类似的非阻塞变种PQconnectStartParams和PQconnectPoll）。

示例

请参见示例章节。