VastbaseG100

基于openGauss内核开发的企业级关系型数据库。

Menu

PQsetvalue

功能描述

设置一个PGresult对象的一个元组域值。

接口原型

int PQsetvalue(PGresult *res, int tup_num, int field_num, char *value, int len);

参数说明

参数 描述
conn 建立连接时返回的连接结构体指针,该指针用于标识某个特定连接。
tup_num 指定元组位置,必须小于等于PQntuples,意味着这个函数对元组数组一次只能增加一个元组。
field_num 指定域值的位置。
value 指定的要设置值的具体内容。
len value的长度,若为-1,或者value指针为空,该域值会被设置为一个 SQL 空值。

返回值

这个函数将自动按需增加结果的内置元组数组。但是,tup_num参数必须小于等于PQntuples,意味着这个函数对元组数组一次只能增加一个元组。但已存在的任意元组中的任意域可以以任意顺序进行调整。如果field_num的一个值已经存在,它会被覆盖。如果len是 -1,或value是NULL, 该域值会被设置为一个 SQL 空值。value会被复制到结果的私有存储中,因此函数返回后就不再需要了。如果函数失败,返回值是 0。如果函数成功,返回值会是非 0。

其他

无。