在 COPY_IN 状态中向服务器发送数据。

int PQputCopyData(PGconn *conn,
                  const char *buffer,
                  int nbytes);

将指定 buffer 中长度为 nbytes 的 COPY 数据传输到服务器。数据成功加入队列时返回 1；因缓冲区已满而无法加入队列时返回零（仅可能发生在非阻塞模式下）；发生错误时返回 -1。（返回 -1 时，可用 PQerrorMessage 获取详细信息。返回零时，应等待可写就绪后重试。）

应用程序可以将 COPY 数据流分成任意方便大小的数据块，逐块装入缓冲区。发送时，这些数据块的边界没有语义含义。数据流内容必须符合 COPY 命令预期的数据格式；详见 COPY。

在 COPY_IN 状态中向服务器发送数据结束的指示。

int PQputCopyEnd(PGconn *conn,
                 const char *errormsg);

如果 errormsg 为 NULL，则成功结束 COPY_IN 操作。如果 errormsg 不为 NULL，则强制 COPY 失败，并将 errormsg 指向的字符串用作错误消息。（但不应假定服务器一定会返回这条完全相同的错误消息，因为服务器可能已经因自身原因使 COPY 失败。）

终止消息已发送时返回 1；在非阻塞模式下，返回 1 也可能仅表示该消息已成功加入发送队列。（在非阻塞模式下，要确认数据已经发送，应接着等待可写就绪并调用 PQflush，反复执行直到返回零。）返回零表示缓冲区已满，无法将终止消息加入队列；这种情况仅可能发生在非阻塞模式下。（此时，应等待可写就绪，再次调用 PQputCopyEnd。）发生严重错误时返回 -1，可用 PQerrorMessage 获取详细信息。

成功调用 PQputCopyEnd 后，调用 PQgetResult 获取 COPY 命令的最终结果状态。可以按通常方式等待该结果就绪，然后恢复正常操作。

在 COPY_OUT 状态下从服务器接收数据。

int PQgetCopyData(PGconn *conn,
                  char **buffer,
                  int async);

在 COPY 期间尝试从服务器获取下一行数据。每次总是返回一个完整数据行；如果只有部分行可用，则不返回。成功返回数据行时，会分配一块内存保存数据。buffer 参数必须为非 NULL。*buffer 会被设置为指向所分配的内存；如果没有返回缓冲区，则设为 NULL。非 NULL 的结果缓冲区在不再需要时应使用 PQfreemem 释放。

成功返回一行时，返回值是该行的数据字节数，始终大于零。返回的字符串总是以零字节结尾，不过这可能仅对文本 COPY 有用。返回零表示 COPY 仍在进行，但尚无可用行（仅在 async 为真时可能发生）。返回 -1 表示 COPY 已完成；返回 -2 表示发生了错误（可用 PQerrorMessage 查看原因）。

当 async 为真（非零）时，PQgetCopyData 不会阻塞等待输入；如果 COPY 仍在进行，但没有完整行可用，则返回零。（此时，应等待读就绪，先调用 PQconsumeInput，再调用 PQgetCopyData。）当 async 为假（零）时，PQgetCopyData 会阻塞，直到数据可用或操作完成。

在 PQgetCopyData 返回 -1 后，调用 PQgetResult 获取 COPY 命令的最终结果状态。可以按通常方式等待该结果就绪，然后恢复正常操作。

将服务器传来的、以换行符结尾的一行字符读入大小为 length 的字符串缓冲区。

int PQgetline(PGconn *conn,
              char *buffer,
              int length);

此函数最多将 length-1 个字符复制到缓冲区，并将末尾的换行符转换为零字节。PQgetline 在输入结束时返回 EOF，读完一整行时返回 0，缓冲区已满但尚未读到末尾换行符时返回 1。

注意，应用程序必须检查新读入的一行是否仅由 \. 两个字符组成，这表示服务器已发送完 COPY 命令的结果。如果可能收到长度超过 length-1 个字符的行，必须确保正确识别 \. 行，例如不能把长数据行的末尾误当作终止行。

以非阻塞方式将服务器传来的一行 COPY 数据读入缓冲区。

int PQgetlineAsync(PGconn *conn,
                   char *buffer,
                   int bufsize);

此函数类似于 PQgetline，但可用于必须异步读取 COPY 数据的应用程序，即读取时不阻塞。发出 COPY 命令并收到 PGRES_COPY_OUT 响应后，应用程序应调用 PQconsumeInput 和 PQgetlineAsync，直到检测到数据结束信号。

与 PQgetline 不同，此函数会负责检测数据结束。

每次调用时，如果 libpq 的输入缓冲区中有完整数据行，PQgetlineAsync 就会返回数据；否则，要等该行剩余部分到达后才返回数据。识别到复制数据结束标记时返回 -1，没有可用数据时返回 0，否则返回正数，表示返回的数据字节数。返回 -1 后，调用者必须接着调用 PQendcopy，然后恢复正常处理。

返回的数据不会跨越数据行边界。只要可能，每次就返回一整行；但如果调用者提供的缓冲区太小，容不下服务器发送的一行，则只返回部分行。对于文本数据，可检查最后返回的字节是否为 \n，以判断是否返回了完整行。（对于二进制 COPY，则必须实际解析 COPY 数据格式才能作出相同判断。）返回的字符串不以零字节结尾。（如果要自行添加末尾的零字节，务必将传入的 bufsize 设置为比实际可用空间少一字节。）

向服务器发送以零字节结尾的字符串。成功时返回 0，无法发送字符串时返回 EOF。

int PQputline(PGconn *conn,
              const char *string);

连续调用 PQputline 发送的 COPY 数据流，与 PQgetlineAsync 返回的数据格式相同。不过，应用程序不必在每次 PQputline 调用中恰好发送一个数据行；每次发送部分行或多行也可以。

向服务器发送不以零字节结尾的字符串。成功时返回 0，无法发送字符串时返回 EOF。

int PQputnbytes(PGconn *conn,
                const char *buffer,
                int nbytes);

此函数与 PQputline 完全相同，只是直接指定了要发送的字节数，因此数据缓冲区不必以零字节结尾。发送二进制数据时可使用此函数。

与服务器同步。

int PQendcopy(PGconn *conn);

此函数会等待服务器完成复制。应在使用 PQputline 向服务器发送最后一个字符串后，或使用 PQgetline 从服务器接收最后一个字符串后调用它。必须调用此函数，否则服务器与客户端会“失去同步”。函数返回后，服务器便准备好接收下一条 SQL 命令。成功完成时返回 0，否则返回非零值。（返回非零值时，可用 PQerrorMessage 获取详细信息。）

使用 PQgetResult 时，收到 PGRES_COPY_OUT 结果后，应用程序应反复调用 PQgetline，并在看到终止行后调用 PQendcopy。随后应回到 PQgetResult 循环，直到 PQgetResult 返回空指针。类似地，收到 PGRES_COPY_IN 结果后，应连续调用 PQputline，再调用 PQendcopy，然后回到 PQgetResult 循环。这样可以保证嵌在一系列 SQL 命令中的 COPY 命令正确执行。

旧的应用很可能会通过 PQexec 提交一个 COPY 命令并且假定事务在 PQendcopy 之后完成。只有在 COPY 是命令字符串中唯一的 SQL 命令时才能正确工作。