# bzwrite

(PHP 4 >= 4.0.4, PHP 5, PHP 7)

bzwrite — 二进制安全地写入 bzip2 文件

### 说明

bzwrite ( resource `$bz` , string `$data` [, int `$length` ] ) : int

bzwrite() 把字符串（string）写入了指定的 bzip2 文件流。

### 参数

`bz`

  文件指针。它必须是有效的并且指向 bzopen() 成功打开的文件。

`data`

  要写入的数据。

`length`

  如果提供了这个参数，将仅仅写入 `length`（未压缩）个字节，若 `data` 小于该指定的长度则写入全部数据。

### 返回值

返回写入的数据字节数，错误时返回 `FALSE`。

### 范例

Example #1 bzwrite() 范例

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

### 参见

- bzread() - bzip2 文件二进制安全地读取
- bzopen() - 打开 bzip2 压缩文件