pg_field_num

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

pg_field_numRetorna o número do campo para o campo nomeado

Descrição

pg_field_num(PgSql\Result $result, string $field): int

pg_field_num() retornará o número do campo que corresponde ao field na instância de result fornecida.

Note:

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

Parâmetros

result

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

field

O nome do campo. O nome fornecido é tratado como um identificador em um comando SQL, ou seja, é colocado em minúscula, a menos que esteja entre aspas duplas.

Valor Retornado

O número do campo (numerado de 0) ou -1 em caso de erro.

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

Example #1 Obtendo informações sobre os campos

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

  $res = pg_query($dbconn, "select author, year, title from authors where author = 'Orwell'");

  echo "A coluna 'title' é o campo número: ", pg_field_num($res, 'title');
?>

O exemplo acima produzirá:

A coluna 'title' é o campo número: 2

Veja Também