bzwrite

Binary safe bzip2 file write

&reftitle.description; ``int``false```bzwrite` `resource` `bz` `string` `data` ``int``null```length`&null;

`bzwrite` writes a string into the given bzip2 file stream.

&reftitle.parameters;

`bz`

- The file pointer. It must be valid and must point to a file successfully opened by `bzopen`.

`data`

- The written data.

`length`

- If supplied, writing will stop after `length` (uncompressed) bytes have been written or the end of `data` is reached, whichever comes first.

&reftitle.returnvalues;

Returns the number of bytes written, or &false; on error.

&reftitle.changelog;

&Version; | &Description;
8.0.0 | `length` is nullable now.

&reftitle.examples;

### `bzwrite` example

    <?php
    $str = "uncompressed data";
    $bz = bzopen("/tmp/foo.bz2", "w");
    bzwrite($bz, $str, strlen($str));
    bzclose($bz);
    ?>

&reftitle.seealso;

- `bzread`
- `bzopen`