Copia datos desde un flujo hacia otro

# stream_copy_to_stream

(PHP 5, PHP 7, PHP 8)

stream_copy_to_stream — Copia datos desde un flujo hacia otro

### Descripción

function stream_copy_to_stream(
resource `$from`,
resource `$to`,
?int `$length` = `null`,
int `$offset` = 0
): int|false

Realiza una copia de hasta `length` bytes de datos desde la posición actual del puntero (o desde la posición `offset`, si se especifica) en el flujo `from` hacia el parámetro `to`. Si `length` no está especificado, se copiará todo el resto del flujo `from`.

### Parámetros

`from`

  El flujo de origen

`to`

  El flujo de destino

`length`

  Número máximo de bytes a copiar. Por omisión, se copian todos los bytes restantes.

`offset`

  El desplazamiento donde comenzar la copia de datos

### Valores devueltos

Devuelve el número total de bytes copiados, o `false` si ocurre un error.

### Historial de cambios

Versión | Descripción
--- | ---
8.0.0 | `length` ahora es nullable.

### Ejemplos

Ejemplo #1 Ejemplo con stream_copy_to_stream()

    <?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 copiados a first1k.txt\n";
    echo stream_copy_to_stream($src, $dest2) . " bytes copiados a remainder.txt\n";

    ?>

### Ver también

- copy() - Copia un fichero

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open