Home/ Manual/ pgsql / functions/ pg_field_is_null

pg_field_is_null

PHP function Edit on GitHub ✎

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

Test if a field is SQL NULL

Description

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() tests if a field in an PgSql\Result instance is SQL NULL or not.

Note

This function used to be called pg_fieldisnull().

Parameters

result: Result
row: Row number in result to fetch. Rows are numbered from 0 upwards. If omitted, current row is fetched.
field: Field number (starting from 0) as an int or the field name as a string.

Return Values

Returns 1 if the field in the given row is SQL NULL, 0 if not. false is returned if the row is out of range, or upon any other error.

Changelog

Version	Description
8.4.0	The two argument signature of `pg_field_is_null()` (`result`, `field`) is now deprecated. Use the three argument signature with `row` set to null instead.
8.3.0	`row` is now nullable.

Examples

pg_field_is_null() example

php

<?php
  $dbconn = pg_connect("dbname=publisher") or die ("Could not connect");
  $res = pg_query($dbconn, "select * from authors where author = 'Orwell'");
  if ($res) {
      if (pg_field_is_null($res, 0, "year") == 1) {
          echo "The value of the field year is null.\n";
      }
      if (pg_field_is_null($res, 0, "year") == 0) {
          echo "The value of the field year is not null.\n";
    }
 }
?>

Source: reference/pgsql/functions/pg-field-is-null.xml · from the official PHP manual (php/doc-en)