pg_set_chunked_rows_size

Set the query results to be retrieved in chunk mode

&reftitle.description; `bool` `pg_set_chunked_rows_size` `PgSql\Connection` `connection` `int` `size`

Set the query results to be retrieved in chunk mode. The query results returned afterward will be divided into multiple chunks, each containing up to `size` rows. This function must be called before retrieving results with `pg_get_result`. This function is only available when libpq is version 17 or higher.

&reftitle.parameters;

`connection`

- &pgsql.parameter.connection;

`size`

- The number of rows to be retrieved in each chunk.

&reftitle.returnvalues;

&return.success;

&reftitle.errors;

If `size` is less than `1`, a `ValueError` will be thrown.

&reftitle.examples;

### `pg_result_memory_size` example

    <?php

    $conn = pg_connect($conn_str);

    for ($i = 0; $i < 10; $i ++) {
      pg_query($conn, "INSERT INTO users DEFAULT VALUES");
    }

    pg_send_query($conn, "SELECT * FROM users");
    pg_set_chunked_rows_size($conn, 1);

    $result = pg_get_result($conn);
    var_dump(pg_num_rows($result));

    // No effect after the result is retrieved
    var_dump(pg_set_chunked_rows_size($conn, 10));

&example.outputs;

    int(1)
    bool(false)

&reftitle.seealso;

- `pg_get_result`
- `pg_result_status`