oci_fetch_assoc

Returns the next row from a query as an associative array

&reftitle.description; ``array``false```oci_fetch_assoc` `resource` `statement`

Returns an associative array containing the next result-set row of a query. Each array entry corresponds to a column of the row. This function is typically called in a loop until it returns &false;, indicating no more rows exist.

Calling `oci_fetch_assoc` is identical to calling `oci_fetch_array` with `OCI_ASSOC` + `OCI_RETURN_NULLS`.

&reftitle.parameters;

`statement`

- &oci.arg.statement.id;
&reftitle.returnvalues;

Returns an associative array. If there are no more rows in the `statement` then &false; is returned.

&reftitle.examples;

### `oci_fetch_assoc` Example

    <?php

    $conn = oci_connect('hr', 'welcome', 'localhost/XE');
    if (!$conn) {
        $e = oci_error();
        trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
    }

    $stid = oci_parse($conn, 'SELECT department_id, department_name FROM departments');
    oci_execute($stid);

    while (($row = oci_fetch_assoc($stid)) != false) {
        echo $row['DEPARTMENT_ID'] . " " . $row['DEPARTMENT_NAME'] . "<br>\n";
    }

    oci_free_statement($stid);
    oci_close($conn);

    ?>

&reftitle.notes;

See `oci_fetch_array` for more examples of fetching rows.

&reftitle.seealso;

- `oci_fetch`
- `oci_fetch_all`
- `oci_fetch_array`
- `oci_fetch_object`
- `oci_fetch_row`