Struct tempfile::TempFile
[−]
[src]
pub struct TempFile(_);
An unnamed temporary file.
This variant is secure/reliable in the presence of a pathological temporary file cleaner.
Deletion:
Linux >= 3.11: The temporary file is never linked into the filesystem so it can't be leaked.
Other *nix: The temporary file is immediately unlinked on create. The OS will delete it when the last open copy of it is closed (the last TempFile reference to it is dropped).
Windows: The temporary file is marked DeleteOnClose and, again, will be deleted when the last open copy of it is closed. Unlike *nix operating systems, the file is not immediately unlinked from the filesystem.
Methods
impl TempFile
[src]
fn new() -> Result<TempFile>
Create a new temporary file.
fn new_in<P: AsRef<Path>>(dir: P) -> Result<TempFile>
Create a new temporary file in the specified directory.
fn shared(count: usize) -> Result<Vec<TempFile>>
Create a new temporary file and open it count
times returning count
independent
references to the same file.
This can be useful if you want multiple seek positions in the same temporary file. Additionally, this function guarantees that all of the returned temporary file objects refer to the same underlying temporary file even in the presence of a pathological temporary file cleaner.
fn shared_in<P: AsRef<Path>>(dir: P, count: usize) -> Result<Vec<TempFile>>
Same as shared
but creates the file in the specified directory.
fn len(&self) -> Result<u64>
Number of bytes in the file.
fn set_len(&self, size: u64) -> Result<()>
Truncate the file to size
bytes.
Trait Implementations
impl Debug for TempFile
[src]
impl Read for TempFile
[src]
fn read(&mut self, buf: &mut [u8]) -> Result<usize>
Pull some bytes from this source into the specified buffer, returning how many bytes were read. Read more
fn read_to_end(&mut self, buf: &mut Vec<u8>) -> Result<usize, Error>
1.0.0
Read all bytes until EOF in this source, placing them into buf
. Read more
fn read_to_string(&mut self, buf: &mut String) -> Result<usize, Error>
1.0.0
Read all bytes until EOF in this source, placing them into buf
. Read more
fn read_exact(&mut self, buf: &mut [u8]) -> Result<(), Error>
1.6.0
Read the exact number of bytes required to fill buf
. Read more
fn by_ref(&mut self) -> &mut Self
1.0.0
Creates a "by reference" adaptor for this instance of Read
. Read more
fn bytes(self) -> Bytes<Self>
1.0.0
Transforms this Read
instance to an Iterator
over its bytes. Read more
fn chars(self) -> Chars<Self>
io
): the semantics of a partial read/write of where errors happen is currently unclear and may change
Transforms this Read
instance to an Iterator
over char
s. Read more
fn chain<R>(self, next: R) -> Chain<Self, R> where R: Read
1.0.0
Creates an adaptor which will chain this stream with another. Read more
fn take(self, limit: u64) -> Take<Self>
1.0.0
Creates an adaptor which will read at most limit
bytes from it. Read more
impl Write for TempFile
[src]
fn write(&mut self, buf: &[u8]) -> Result<usize>
Write a buffer into this object, returning how many bytes were written. Read more
fn flush(&mut self) -> Result<()>
Flush this output stream, ensuring that all intermediately buffered contents reach their destination. Read more
fn write_all(&mut self, buf: &[u8]) -> Result<(), Error>
1.0.0
Attempts to write an entire buffer into this write. Read more
fn write_fmt(&mut self, fmt: Arguments) -> Result<(), Error>
1.0.0
Writes a formatted string into this writer, returning any error encountered. Read more
fn by_ref(&mut self) -> &mut Self
1.0.0
Creates a "by reference" adaptor for this instance of Write
. Read more
impl Seek for TempFile
[src]
fn seek(&mut self, pos: SeekFrom) -> Result<u64>
Seek to an offset, in bytes, in a stream. Read more