Struct DataRecord

Source

pub struct DataRecord<'a> {
    pub data_record_header: DataRecordHeader<'a>,
    pub data: Data<'a>,
    pub raw_bytes: &'a [u8],
}

Fields§

§data_record_header: DataRecordHeader<'a>§data: Data<'a>§raw_bytes: &'a [u8]

Raw bytes encompassing this data record

Implementations§

Source §

impl DataRecord<'_>

Source

pub fn value(&self) -> Option<&DataType<'_>>

Returns the parsed value carried by this record.

Examples found in repository ?

examples/parse_data_records.rs (line 14)

3fn main() -> Result<(), DataRecordError> {
4    // Application-layer records only: no wired/wireless frame or CI/TPL header.
5    let data = [
6        0x03, 0x13, 0x15, 0x31, 0x00, // Volume: 12_565 x 10^-3 m³
7        0x02, 0x5A, 0xD7, 0x04, // Flow temperature: 1_239 x 10^-1 °C
8    ];
9
10    for (index, record) in parse_data_records(&data).enumerate() {
11        let record = record?;
12
13        println!("Record {}", index + 1);
14        println!("  value: {:?}", record.value());
15        if let Some(value_information) = record.value_information() {
16            println!("  labels: {:?}", value_information.labels);
17            println!("  scale: 10^{}", value_information.decimal_scale_exponent);
18            println!("  units: {:?}", value_information.units);
19        }
20        println!("  raw bytes: {:02X?}", record.raw_bytes());
21    }
22
23    Ok(())
24}

Source

pub fn data_information(&self) -> Option<&DataInformation>

Returns the processed data information (DIF and DIFE fields).

Source

pub fn value_information(&self) -> Option<&ValueInformation>

Returns the processed value information (VIF and VIFE fields).

Examples found in repository ?

examples/parse_data_records.rs (line 15)

3fn main() -> Result<(), DataRecordError> {
4    // Application-layer records only: no wired/wireless frame or CI/TPL header.
5    let data = [
6        0x03, 0x13, 0x15, 0x31, 0x00, // Volume: 12_565 x 10^-3 m³
7        0x02, 0x5A, 0xD7, 0x04, // Flow temperature: 1_239 x 10^-1 °C
8    ];
9
10    for (index, record) in parse_data_records(&data).enumerate() {
11        let record = record?;
12
13        println!("Record {}", index + 1);
14        println!("  value: {:?}", record.value());
15        if let Some(value_information) = record.value_information() {
16            println!("  labels: {:?}", value_information.labels);
17            println!("  scale: 10^{}", value_information.decimal_scale_exponent);
18            println!("  units: {:?}", value_information.units);
19        }
20        println!("  raw bytes: {:02X?}", record.raw_bytes());
21    }
22
23    Ok(())
24}

Source

pub fn raw_bytes(&self) -> &[u8] ⓘ

Returns all raw bytes consumed by this record.

Examples found in repository ?

examples/parse_data_records.rs (line 20)

3fn main() -> Result<(), DataRecordError> {
4    // Application-layer records only: no wired/wireless frame or CI/TPL header.
5    let data = [
6        0x03, 0x13, 0x15, 0x31, 0x00, // Volume: 12_565 x 10^-3 m³
7        0x02, 0x5A, 0xD7, 0x04, // Flow temperature: 1_239 x 10^-1 °C
8    ];
9
10    for (index, record) in parse_data_records(&data).enumerate() {
11        let record = record?;
12
13        println!("Record {}", index + 1);
14        println!("  value: {:?}", record.value());
15        if let Some(value_information) = record.value_information() {
16            println!("  labels: {:?}", value_information.labels);
17            println!("  scale: 10^{}", value_information.decimal_scale_exponent);
18            println!("  units: {:?}", value_information.units);
19        }
20        println!("  raw bytes: {:02X?}", record.raw_bytes());
21    }
22
23    Ok(())
24}