W3cubDocs

/Rust

Function std::io::copy

pub fn copy<R: ?Sized, W: ?Sized>(reader: &mut R, writer: &mut W) -> Result<u64> where R: Read, W: Write

Copies the entire contents of a reader into a writer.

This function will continuously read data from reader and then write it into writer in a streaming fashion until reader returns EOF.

On success, the total number of bytes that were copied from reader to writer is returned.

Errors

This function will return an error immediately if any call to read or write returns an error. All instances of ErrorKind::Interrupted are handled by this function and the underlying operation is retried.

Examples

use std::io;

let mut reader: &[u8] = b"hello";
let mut writer: Vec<u8> = vec![];

io::copy(&mut reader, &mut writer)?;

assert_eq!(reader, &writer[..]);

© 2010 The Rust Project Developers
Licensed under the Apache License, Version 2.0 or the MIT license, at your option.
https://doc.rust-lang.org/std/io/fn.copy.html