pg_lo_write
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
pg_lo_write — 큰 객체에 쓰기
설명
pg_lo_write(PgSql\Lob $lob
, string $data
, ?int $length
= null
): int|false
pg_lo_write()는 현재 탐색 위치에서 큰 객체에 데이터를 씁니다.
Large Object Interface를 사용하기 위해서는 이를 트랜잭션 블록으로 묶어야 합니다.
메모: 이 함수는 pg_lowrite()라고 불렸습니다.
매개변수
lob
- pg_lo_open()에 의해 반환된 PgSql\Lob 인스턴스.
data
- 큰 개체에 쓸 데이터입니다.
length
가 int이고data
길이보다 작으면length
바이트만 기록됩니다. length
- 쓸 최대 바이트 수(선택 사항). 0보다 크고
data
길이보다 크지 않아야 합니다. 기본값은data
길이입니다.
반환 값
대형 개체에 기록된 바이트 수 또는 오류 시 false
입니다.
변경 로그
버전 | 설명 |
---|---|
8.1.0 | lob 매개변수는 이제 PgSql\Lob 인스턴스를 예상합니다. 이전에는 resource가 필요했습니다. |
8.0.0 | length 는 이제 nullable입니다. |
Examples
예제 #1 pg_lo_write() 예제
<?php
$doc_oid = 189762345;
$data = "This will overwrite the start of the large object.";
$database = pg_connect("dbname=jacarta");
pg_query($database, "begin");
$handle = pg_lo_open($database, $doc_oid, "w");
$data = pg_lo_write($handle, $data);
pg_query($database, "commit");
?>
기타
- pg_lo_create() - 큰 개체 만들기
- pg_lo_open() - 큰 개체 열기