std::io::copy - Rust
Description: API documentation for the Rust `copy` fn in crate `std`.
Keywords: rust, rustlang, rust-lang, copy

# 1.0.0[−][src]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.

If you’re wanting to copy the contents of one file to another and you’re working with filesystem paths, see the `fs::copy` function.

# 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;

    fn main() -> io::Result<()> {
        let mut reader: &[u8] = b"hello";
        let mut writer: Vec<u8> = vec![];

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

        assert_eq!(&b"hello"[..], &writer[..]);
        Ok(())
    }Run

# Help

## Keyboard Shortcuts

`?`
  Show this help dialog
`S`
  Focus the search field
`↑`
  Move up in search results
`↓`
  Move down in search results
`↹`
  Switch tab
`⏎`
  Go to active search result
`+`
  Expand all sections
`-`
  Collapse all sections

## Search Tricks

Prefix searches with a type followed by a colon (e.g. `fn:`) to restrict the search to a given type.

Accepted types are: `fn`, `mod`, `struct`, `enum`, `trait`, `type`, `macro`, and `const`.

Search functions by type signature (e.g. `vec -> usize` or `* -> vec`)

Search multiple things at once by splitting your query with comma (e.g. `str,u8` or `String,struct:Vec,test`)