pg_put_line

(PHP 4 >= 4.0.3, PHP 5, PHP 7)

pg_put_line - 发送以NULL结尾的字符串到PostgreSQL后端

描述

bool pg_put_line ([ resource $connection ], string $data )

pg_put_line（）向PostgreSQL后端服务器发送一个以NULL结尾的字符串。这需要与PostgreSQL的COPY FROM命令结合使用。

COPY是PostgreSQL支持的高速数据加载界面。数据被传入而不被解析，并且在单个事务中。

使用原始pg_put_line（）命令的替代方法是使用pg_copy_from（）。这是一个非常简单的界面。

注意：应用程序必须明确发送两个字符“。” 在发出pg_end_copy（）之前向最后一行指示它已完成发送它的数据。

警告

使用pg_put_line（）会导致大多数大对象操作（包括pg_lo_read（）和pg_lo_tell（））随后失败。您可以使用pg_copy_from（）和pg_copy_to（）来代替。

参数

connection

PostgreSQL数据库连接资源。如果connection不存在，则使用默认连接。默认连接是pg_connect（）或pg_pconnect（）所做的最后一个连接。

data

一行文本直接发送到PostgreSQL后端。一个NULL结束符被自动添加。

返回值

返回TRUE成功或返回FALSE失败。

例子

Example #1 pg_put_line() example

<?php 
  $conn = pg_pconnect("dbname=foo"
  pg_query($conn, "create table bar (a int4, b char(16), d float8)"
  pg_query($conn, "copy bar from stdin"
  pg_put_line($conn, "3\thello world\t4.5\n"
  pg_put_line($conn, "4\tgoodbye world\t7.11\n"
  pg_put_line($conn, "\\.\n"
  pg_end_copy($conn
?>