# stream_copy_to_stream

(PHP 5, PHP 7)

stream_copy_to_stream — Copies data from one stream to another

### 说明

stream_copy_to_stream ( resource `$source` , resource `$dest` [, int `$maxlength` = -1 [, int `$offset` = 0 ]] ) : int

Makes a copy of up to `maxlength` bytes of data from the current position (or from the `offset` position, if specified) in `source` to `dest`. If `maxlength` is not specified, all remaining content in `source` will be copied.

### 参数

`source`

  The source stream

`dest`

  The destination stream

`maxlength`

  Maximum bytes to copy

`offset`

  The offset where to start to copy data

### 返回值

Returns the total count of bytes copied, 或者在失败时返回 `FALSE`.

### 更新日志

版本 | 说明
--- | ---
5.1.0 | Added the `offset` parameter

### 范例

Example #1 A stream_copy_to_stream() example

    <?php
    $src = fopen('http://www.example.com', 'r');
    $dest1 = fopen('first1k.txt', 'w');
    $dest2 = fopen('remainder.txt', 'w');

    echo stream_copy_to_stream($src, $dest1, 1024) . " bytes copied to first1k.txt\n";
    echo stream_copy_to_stream($src, $dest2) . " bytes copied to remainder.txt\n";

    ?>

### 参见

- copy() - 拷贝文件