ambers 0.3.9

Pure Rust reader for SPSS .sav and .zsav files
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
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

use crate::error::{Result, SpssError};

/// A set of value labels for a long string variable.
#[derive(Debug, Clone)]
pub struct LongStringLabelSet {
    /// Variable name.
    pub var_name: String,
    /// (value, label) pairs.
    pub labels: Vec<(Vec<u8>, Vec<u8>)>,
}

/// Parse subtype 21: long string value labels.
///
/// Format (for each variable):
///   4-byte var_name_length
///   var_name bytes
///   4-byte var_width
///   4-byte label_count
///   For each label:
///     4-byte value_length
///     value bytes
///     4-byte label_length
///     label bytes
pub fn parse_long_string_labels(data: &[u8]) -> Result<Vec<LongStringLabelSet>> {
    let mut result = Vec::new();
    let mut pos = 0;

    while pos + 4 <= data.len() {
        // Variable name
        let name_len = read_i32_le(data, pos)? as usize;
        pos += 4;
        if pos + name_len > data.len() {
            break;
        }
        let var_name = String::from_utf8_lossy(&data[pos..pos + name_len])
            .trim()
            .to_string();
        pos += name_len;

        // Variable width (skip — used for value padding)
        if pos + 4 > data.len() {
            break;
        }
        // let _var_width = read_i32_le(data, pos)?;
        pos += 4;

        // Label count
        if pos + 4 > data.len() {
            break;
        }
        let label_count = read_i32_le(data, pos)? as usize;
        pos += 4;

        let mut labels = Vec::with_capacity(label_count);
        for _ in 0..label_count {
            // Value length + value
            if pos + 4 > data.len() {
                break;
            }
            let value_len = read_i32_le(data, pos)? as usize;
            pos += 4;
            if pos + value_len > data.len() {
                break;
            }
            let value = data[pos..pos + value_len].to_vec();
            pos += value_len;

            // Label length + label
            if pos + 4 > data.len() {
                break;
            }
            let label_len = read_i32_le(data, pos)? as usize;
            pos += 4;
            if pos + label_len > data.len() {
                break;
            }
            let label = data[pos..pos + label_len].to_vec();
            pos += label_len;

            labels.push((value, label));
        }

        result.push(LongStringLabelSet { var_name, labels });
    }

    Ok(result)
}

fn read_i32_le(data: &[u8], pos: usize) -> Result<i32> {
    if pos + 4 > data.len() {
        return Err(SpssError::TruncatedFile {
            expected: pos + 4,
            actual: data.len(),
        });
    }
    let bytes: [u8; 4] = data[pos..pos + 4].try_into().unwrap();
    Ok(i32::from_le_bytes(bytes))
}