summaryrefslogtreecommitdiffstats
path: root/vendor/rustix/src/io/seek_from.rs
blob: cca23ed625f6bf2804b6228985496a50926997e3 (plain)
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
38
39
40
41
42
43
44
45
46
47
48
//! The following is derived from Rust's
//! library/std/src/io/mod.rs at revision
//! dca3f1b786efd27be3b325ed1e01e247aa589c3b.

/// Enumeration of possible methods to seek within an I/O object.
///
/// It is used by the [`Seek`] trait.
///
/// [`Seek`]: std::io::Seek
#[derive(Copy, PartialEq, Eq, Clone, Debug)]
#[cfg_attr(staged_api, stable(feature = "rust1", since = "1.0.0"))]
pub enum SeekFrom {
    /// Sets the offset to the provided number of bytes.
    #[cfg_attr(staged_api, stable(feature = "rust1", since = "1.0.0"))]
    Start(#[cfg_attr(staged_api, stable(feature = "rust1", since = "1.0.0"))] u64),

    /// Sets the offset to the size of this object plus the specified number of
    /// bytes.
    ///
    /// It is possible to seek beyond the end of an object, but it's an error
    /// to seek before byte 0.
    #[cfg_attr(staged_api, stable(feature = "rust1", since = "1.0.0"))]
    End(#[cfg_attr(staged_api, stable(feature = "rust1", since = "1.0.0"))] i64),

    /// Sets the offset to the current position plus the specified number of
    /// bytes.
    ///
    /// It is possible to seek beyond the end of an object, but it's an error
    /// to seek before byte 0.
    #[cfg_attr(staged_api, stable(feature = "rust1", since = "1.0.0"))]
    Current(#[cfg_attr(staged_api, stable(feature = "rust1", since = "1.0.0"))] i64),

    /// Sets the offset to the current position plus the specified number of bytes,
    /// plus the distance to the next byte which is not in a hole.
    ///
    /// If the offset is in a hole at the end of the file, the seek will produce
    /// an `NXIO` error.
    #[cfg(any(freebsdlike, target_os = "linux", target_os = "solaris"))]
    Data(i64),

    /// Sets the offset to the current position plus the specified number of bytes,
    /// plus the distance to the next byte which is in a hole.
    ///
    /// If there is no hole past the offset, it will be set to the end of the file
    /// i.e. there is an implicit hole at the end of any file.
    #[cfg(any(freebsdlike, target_os = "linux", target_os = "solaris"))]
    Hole(i64),
}