io-ranges 0.0.0

Random-access I/O
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

//! Random-access I/O
//!
//! For a starting point, see [`FileReader`] and [`FileWriter`] for input and
//! output. There's also [`FileEditor`] for combination input and output.

#![deny(missing_docs)]
#![cfg_attr(can_vector, feature(can_vector))]
#![cfg_attr(write_all_vectored, feature(write_all_vectored))]

mod borrow_streamer;
mod files;
#[cfg(feature = "io-streams")]
mod own_streamer;
#[cfg(not(windows))]
mod posish;
mod slice;
#[cfg(windows)]
mod windows;

/// Functions for implementing `ReadAt` and `WriteAt` for file-like types.
pub mod filelike {
    // We can't use Windows' `read_at` or `write_at` here because it isn't able to
    // extend the length of a file we can't `reopen` (such as temporary files).
    // However, while `FileIoExt` can't use `seek_write` because it mutates the
    // current position, here we *can* use plain `seek_write` because `FileEditor`
    // doesn't expose the current position.
    #[cfg(not(windows))]
    pub use crate::posish::*;
    #[cfg(windows)]
    pub use crate::windows::*;
}

pub use files::{
    EditAt, FileEditor, FileReader, FileWriter, Metadata, MinimalFile, ReadAt, WriteAt,
};

pub use system_interface::fs::Advice;