pg_field_is_null

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

pg_field_is_nullTesta se um campo é SQL NULL

Descrição

pg_field_is_null(PgSql\Result $result, string|false|null $row, mixed $field): int
pg_field_is_null(PgSql\Result $result, mixed $field): int

pg_field_is_null() testa se um campo em uma instância PgSql\Result é SQL NULL ou não.

Note:

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

Parâmetros

result

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

row

Número da linha no resultado a ser buscado. As linhas são numeradas de 0 para cima. Se omitido, a linha atual será buscada.

field

Número do campo (começando em 0) como um int ou o nome do campo como uma string.

Valor Retornado

Retorna 1 se o campo na linha fornecida for SQL NULL, 0 se não for. false é retornado se a linha estiver fora do intervalo ou em caso de qualquer outro erro.

Registro de Alterações

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

Exemplos

Example #1 Exemplo de pg_field_is_null()

<?php
  $dbconn = pg_connect("dbname=publisher") or die ("Não foi possível conectar");
  $res = pg_query($dbconn, "select * from authors where author = 'Orwell'");
  if ($res) {
      if (pg_field_is_null($res, 0, "year") == 1) {
          echo "O valor do campo year é nulo.\n";
      }
      if (pg_field_is_null($res, 0, "year") == 0) {
          echo "O valor do campo year não é nulo.\n";
    }
 }
?>