pg_field_table

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

pg_field_table — Retorna o nome ou oid do campo da tabela

Descrição

pg_field_table(PgSql\Result $result, int $field, bool $oid_only = false): string|int|false

pg_field_table() retorna o nome da tabela à qual o campo pertence, ou o oid da tabela se oid_only for true.

Parâmetros

result: Uma instância de PgSql\Result, retornada por pg_query(), pg_query_params() ou pg_execute() (entre outras).
field: Número do campo, começando em 0.
oid_only: Por padrão, o nome da tabela à qual o campo pertence é retornado, mas se oid_only estiver definido como true, então o oid será retornado.

Valor Retornado

Em caso de sucesso, o nome da tabela de campos ou oid, ou false em caso de falha.

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 Obtendo informações da tabela sobre um campo

<?php
$dbconn = pg_connect("dbname=publisher") or die("Não foi possível conectar");

$res = pg_query($dbconn, "SELECT bar FROM foo");

echo pg_field_table($res, 0);
echo pg_field_table($res, 0, true);

$res = pg_query($dbconn, "SELECT version()");
var_dump(pg_field_table($res, 0));
?>

O exemplo acima produzirá algo semelhante a:

foo
14379580

bool(false)

Notas

Nota:
Retornar o oid é muito mais rápido do que retornar o nome da tabela porque buscar o nome da tabela requer uma consulta à tabela do sistema do banco de dados.

Veja Também

pg_field_name() - Retorna o nome de um campo
pg_field_type() - Retorna o nome do tipo para o número do campo correspondente

Improve This Page

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 2 notes

down

strata_ranger at hotmail dot com ¶

15 years ago

pg_field_table is primarily useful for queries that involve joins between multiple tables, e.g:

<?php
$res = pg_query("SELECT table1.foo, table2.bar FROM table1 JOIN table2");
echo pg_field_table($res, 0); // Outputs 'table1'
echo pg_field_table($res, 1); // Outputs 'table2'
?>

However, be aware of a few easy 'gotchas':

1- If your query contains static values in its select-list, pg_field_table() will yield FALSE for those fields (because it was a static value, not one fetched from a table):

<?php
$res = pg_query("SELECT 'foo', bar FROM table");
echo pg_field_table($res, 0); // FALSE
echo pg_field_table($res, 1); // Outputs 'table'
?>

2- If you UNION two queries together from different tables, pg_field_table() will return FALSE for all fields:

<?php
$res = pg_query("(Select foo, bar from table1) UNION (Select foo, bar from table2)");
echo pg_field_table($res, 0); // FALSE
echo pg_field_table($res, 1); // FALSE
?>

down

giultar at gmail dot com ¶

4 years ago

this function return an OID even if your field comes from a view or a select but return FALSE if your field comes from an UNION select

＋add a note