fixcol 0.1.0

A library for reading and writing fixed width / column delimited data files.
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

/// Represents the alignment of a field in a fixed length representation
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub enum Alignment {
    /// Field is aligned left
    Left,
    /// Field is aligned right
    Right,
    /// Field takes the full width
    ///
    /// When reading strings, whitespace will not be stripped. This can be
    /// useful to preserve tabular data. Numerical fields will ignore leading
    /// and trailing whitespace when parsing a value from text.
    Full, // TODO: handle incorrect length writes (with strict mode)
}

/// Represents how a field should be encoded in a fixed width column representation
#[derive(Clone, Copy, Debug)]
pub struct FieldDescription {
    /// How many characters to skip between the prior field and this one
    ///
    /// Note, currently limited to 256 for writes
    pub skip: usize,
    /// The number of characters available to hold this field
    pub len: usize,
    /// How data in this field is aligned
    pub alignment: Alignment,
    /// Whether strict mode is enabled for this field.
    pub strict: bool,
}