pg_fetch_assoc

Fetch a row as an associative array

&reftitle.description; ``array``false```pg_fetch_assoc` `PgSql\Result` `result` ``int``null```row`&null;

`pg_fetch_assoc` returns an associative array that corresponds to the fetched row (records).

`pg_fetch_assoc` is equivalent to calling `pg_fetch_array` with `PGSQL_ASSOC` as the optional third parameter. It only returns an associative array. If you need the numeric indices, use `pg_fetch_row`.

&database.fetch-null;

`pg_fetch_assoc` is NOT significantly slower than using `pg_fetch_row`, and is significantly easier to use.

&reftitle.parameters;

`result`

- &pgsql.parameter.result;

`row`

- Row number in result to fetch. Rows are numbered from 0 upwards. If omitted or &null;, the next row is fetched.

&reftitle.returnvalues;

An `array` indexed associatively (by field name). Each value in the `array` is represented as a `string`. Database `NULL` values are returned as &null;.

&false; is returned if `row` exceeds the number of rows in the set, there are no more rows, or on any other error.

&reftitle.changelog;

&Version; | &Description;
&pgsql.changelog.result-object;

&reftitle.examples;

### `pg_fetch_assoc` example

    <?php
    $conn = pg_connect("dbname=publisher");
    if (!$conn) {
      echo "An error occurred.\n";
      exit;
    }

    $result = pg_query($conn, "SELECT id, author, email FROM authors");
    if (!$result) {
      echo "An error occurred.\n";
      exit;
    }

    while ($row = pg_fetch_assoc($result)) {
      echo $row['id'];
      echo $row['author'];
      echo $row['email'];
    }
    ?>

&reftitle.seealso;

- `pg_fetch_row`
- `pg_fetch_array`
- `pg_fetch_object`
- `pg_fetch_result`