PQputCopyData
功能描述
在COPY_IN状态里向服务器发送数据。
接口原型
int PQputCopyData(PGconn *conn,
const char *buffer,
int nbytes);
参数说明
参数 | 描述 |
---|---|
conn | 建立连接时返回的连接结构体指针,该指针用于标识某个特定连接。 |
buffer | 向服务器发送的数据buffer。 |
nbytes | 发送数据的字节数。 |
返回值
如果数据发送成功,结果是 1,如果因为发送企图会阻塞 (这种情况只有在连接是非阻塞模式时才有可能)而没有成功,那么是零, 或者是在发生错误的时候是 -1。(如果返回 -1,那么使用PQerrorMessage 检索细节。如果值是零,那么等待写准备好然后重试。)
其他
应用可以把COPY数据流分隔成任意合适的大小放到缓冲区里。在发送的时候, 缓冲区的边界没有什么特殊的语意。数据流的内容必须匹配COPY命令预期的数据格式。