PHP Conference Nagoya 2025

pg_num_fields

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

pg_num_fieldsReturns the number of fields in a result

Description

pg_num_fields(PgSql\Result $result): int

pg_num_fields() returns the number of fields (columns) in the PgSql\Result instance.

Note:

This function used to be called pg_numfields().

Parameters

result

An PgSql\Result instance, returned by pg_query(), pg_query_params() or pg_execute()(among others).

Return Values

The number of fields (columns) in the result. On error, -1 is returned.

Changelog

Version Description
8.1.0 The result parameter expects an PgSql\Result instance now; previously, a resource was expected.

Examples

Example #1 pg_num_fields() example

<?php
$result
= pg_query($conn, "SELECT 1, 2");

$num = pg_num_fields($result);

echo
$num . " field(s) returned.\n";
?>

The above example will output:

2 field(s) returned.

See Also

add a note

User Contributed Notes 1 note

up
-1
mark at redbrick dot dcu dot ie
21 years ago
Here is a simple example for using pg_num_feilds, pg_num_rows and pg_result together. I'm simply SELECTing * from a table named markie on the current pg_connect().

<?php
$pgsql_conn
= pg_connect("dbname=mark host=localhost");

if (!
$pgsql_conn) {
print
pg_last_error($pgsql_conn);
exit;
}

$results = pg_query($pgsql_conn, "SELECT * FROM markie");

echo
"<table border=1>\n";
for(
$lt = 0; $lt < pg_num_rows($results); $lt++) {
echo
"<tr>\n";
for(
$gt = 0; $gt < pg_num_fields($results); $gt++) {
echo
"<td>" . pg_result($results, $lt, $gt) . "</td>\n";
}
echo
"</tr>\n";
}
echo
"</table>\n";

pg_close($pgsql_conn);
?>

This code snippet will print out the rows and columns into a HTML table.

Regards, --mark
To Top