PQconninfoParse
功能描述
从提供的连接字符串中返回解析的连接选项。
接口原型
PQconninfoOption *PQconninfoParse(const char *conninfo, char **errmsg);
参数说明
| 参数 | 说明 |
|---|---|
| conninfo | 输入的连接字符串。可以为空，这样将会使用默认参数。也可以包含由空格分隔的一个或多个参数设置，还可以包含一个URI。 |
| errmsg | 如果errmsg非空，则*errmsg在成功时赋值为NULL；反之，则对*errmsg动态分配内存，并保存解释问题的错误字符串。（*errmsg设置为NULL 并且函数返回NULL是可能的；这表示内存溢出）。如果发生错误并且errmsg非空， 必须使用PQfreemem释放错误字符串。 |
返回值
- 若连接字符串非法，则返回NULL。
- 若连接字符串合法，则返回PQconninfoOption指针，该指针指向一个PQconninfoOption数组，该数组保存输入的连接字符串（conninfo）对应的各个选项，该数组以一个有 NULL keyword指针的条目结束。所有合法选项将在结果数组中显示，但是PQconninfoOption 的任何没有在连接字符串中出现的选项将把val设置为NULL， 缺省值不插入。
其他
在处理完选项数组后，须采用PQconninfoFree进行释放，否则会造成内存泄漏。
