# Coroutine::fwrite [TOC] 协程方式向文件写入数据。 ~~~ function Coroutine::fwrite(resource $handle, string $data, int $length = 0); ~~~ > 需要`2.0.11`或更高版本 ## 参数 * `$handle`文件句柄，必须是`fopen`打开的文件类型`stream`资源 * `$data`要写入的数据内容，可以是文本或二进制数据 * `$length`写入的长度，默认为`0`，表示写入`$data`的全部内容，`$length`必须小于`$data`的长度 ## 返回值 写入成功返回数据长度，失败返回`false` ## 版本差异 `4.0.4`以下版本`fwrite`方法不支持非文件类型的`stream`，如`STDOUT`、`Socket`，请勿使用`fwrite`操作此类资源。 `4.0.4`以上版本`fwrite`方法支持了非文件类型的`stream`资源，底层会自动根据`stream`类型选择使用`AIO`线程池或`EventLoop`实现。 ## 示例 ~~~ use Swoole\Coroutine as co; $fp = fopen(__DIR__ . "/test.data", "a+"); co::create(function () use ($fp) { $r = co::fwrite($fp, "hello world\n", 5); var_dump($r); }); ~~~