Struct path_abs::FileWrite
[−]
[src]
pub struct FileWrite(_);
A write-only file handle with path()
attached and improved error messages. Contains only the
methods and trait implementations which are allowed by a write-only file.
Examples
use std::io::Write; use path_abs::{PathFile, FileWrite}; let example = "example.txt"; let expected = "foo\nbar"; let mut write = FileWrite::create(example)?; write.write_all(expected.as_bytes())?; write.flush(); let file = PathFile::new(example)?; assert_eq!(expected, file.read_string()?);
Methods
impl FileWrite
[src]
fn open<P: AsRef<Path>>(path: P, options: OpenOptions) -> Result<FileWrite>
[src]
Open the file with the given OpenOptions
but always sets write
to true.
fn create<P: AsRef<Path>>(path: P) -> Result<FileWrite>
[src]
Open the file in write-only mode, truncating it first if it exists and creating it otherwise.
fn append<P: AsRef<Path>>(path: P) -> Result<FileWrite>
[src]
Open the file for appending, creating it if it doesn't exist.
fn edit<P: AsRef<Path>>(path: P) -> Result<FileWrite>
[src]
Open the file for editing (reading and writing) but do not create it if it doesn't exist.
fn sync_all(&self) -> Result<()>
[src]
Attempts to sync all OS-internal metadata to disk.
This function will attempt to ensure that all in-core data reaches the filesystem before returning.
This function is identical to std::fs::File::sync_all except it has error messages which include the action and the path.
fn sync_data(&self) -> Result<()>
[src]
This function is similar to sync_all, except that it may not synchronize file metadata to the filesystem.
This function is identical to std::fs::File::sync_data except it has error messages which include the action and the path.
fn set_len(&mut self, size: u64) -> Result<()>
[src]
Truncates or extends the underlying file, updating the size of this file to become size.
This function is identical to std::fs::File::set_len except:
- It has error messages which include the action and the path.
- It takes
&mut self
instead of&self
.
fn set_permissions(&mut self, perm: Permissions) -> Result<()>
[src]
Changes the permissions on the underlying file.
This function is identical to std::fs::File::set_permissions except:
- It has error messages which include the action and the path.
- It takes
&mut self
instead of&self
.
fn write_str(&mut self, s: &str) -> Result<()>
[src]
Shortcut to self.write_all(s.as_bytes())
with slightly
improved error message.
fn flush(&mut self) -> Result<()>
[src]
std::io::File::flush
buth with the new error type.
Methods from Deref<Target = FileOpen>
fn path(&self) -> &PathFile
[src]
Get the path associated with the open file.
fn metadata(&self) -> Result<Metadata>
[src]
Queries metadata about the underlying file.
This function is identical to std::fs::File::metadata except it has error messages which include the action and the path.
fn try_clone(&self) -> Result<FileOpen>
[src]
Creates a new independently owned handle to the underlying file.
This function is identical to std::fs::File::try_clone except it has error
messages which include the action and the path and it returns a FileOpen
object.
Trait Implementations
impl Debug for FileWrite
[src]
impl Write for FileWrite
[src]
fn write(&mut self, buf: &[u8]) -> Result<usize>
[src]
Write a buffer into this object, returning how many bytes were written. Read more
fn flush(&mut self) -> Result<()>
[src]
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[src]
Attempts to write an entire buffer into this write. Read more
fn write_fmt(&mut self, fmt: Arguments) -> Result<(), Error>
1.0.0[src]
Writes a formatted string into this writer, returning any error encountered. Read more
fn by_ref(&mut self) -> &mut Self
1.0.0[src]
Creates a "by reference" adaptor for this instance of Write
. Read more
impl Seek for FileWrite
[src]
fn seek(&mut self, pos: SeekFrom) -> Result<u64>
[src]
Seek to an offset, in bytes, in a stream. Read more