array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.pg-last-oid.php', 1 => 'pg_last_oid', 2 => 'Retorna o OID da última linha', ), 'up' => array ( 0 => 'ref.pgsql.php', 1 => 'Funções PostgreSQL', ), 'prev' => array ( 0 => 'function.pg-last-notice.php', 1 => 'pg_last_notice', ), 'next' => array ( 0 => 'function.pg-lo-close.php', 1 => 'pg_lo_close', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/pgsql/functions/pg-last-oid.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

pg_last_oid

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

pg_last_oid — Retorna o OID da última linha

Descrição

pg_last_oid(PgSql\Result $result): string|int|false

pg_last_oid() é usado para recuperar o OID atribuído a uma linha inserida.

O campo OID tornou-se um campo opcional no PostgreSQL 7.2 e não estará presente por padrão no PostgreSQL 8.1. Quando o campo OID não está presente em uma tabela, o programador deve usar pg_result_status() para verificar se a inserção foi bem-sucedida.

Para obter o valor de um campo SERIAL em uma linha inserida, é necessário utilizar a função CURRVAL do PostgreSQL, nomeando a sequência cujo último valor é requerido. Se o nome da sequência for desconhecido, a função pg_get_serial_sequence do PostgreSQL 8.0 é necessária.

O PostgreSQL 8.1 possui uma função LASTVAL que retorna o valor da sequência usada mais recentemente na sessão. Isso evita a necessidade de nomear completamente a sequência, tabela ou coluna.

Nota:

Esta função costumava ser chamada de pg_getlastoid().

Parâmetros

result

Uma instância de PgSql\Result, retornada por pg_query(), pg_query_params() ou pg_execute() (entre outras).

Valor Retornado

Um int ou string contendo o OID atribuído à linha inserida mais recentemente na connection especificada, ou false por erro ou nenhum OID disponível.

Registro de Alterações

Versão Descrição
8.1.0 O parâmetro result agora espera uma instância de PgSql\Result; anteriormente, um resource era esperado.

Exemplos

Exemplo #1 Exemplo de pg_last_oid()

<?php
// Conecta ao banco de dados
pg_connect("dbname=mark host=localhost");

// Cria uma tabela de exemplo
pg_query("CREATE TABLE test (a INTEGER) WITH OIDS");

// Insira alguns dados nela
$res = pg_query("INSERT INTO test VALUES (1)");

$oid = pg_last_oid($res);
?>

Veja Também