Enum iracing::telemetry::Value

pub enum Value {
    CHAR(u8),
    BOOL(bool),
    INT(i32),
    BITS(u32),
    FLOAT(f32),
    DOUBLE(f64),
    UNKNOWN(()),
    IntVec(Vec<i32>),
    FloatVec(Vec<f32>),
    BoolVec(Vec<bool>),
}

Telemetry Value

Represents a single value in the telemetry. Telemetry data is always quantitive but may be of varying numeric types, plus boolean.

The iRacing Telemetry documentation describes the data-type expected for a given telemetry measurement. Into can be used when the expected data type is known, else match can be used to dynamically handle the returned data type.

Examples

Known, Expected Data Type

use iracing::telemetry::Sample;
 
let s: Sample = some_sample_getter();
 
let gear: i32 = s.get("Gear").unwrap().into();

Unknown data type

use iracing::telemtry::{Sample, Value};
 
let v: &'static str = some_input_for_var_name();
let s: Sample = some_sample_getter();
 
match s.get(v) {
    None => println!("Didn't find that value");
    Some(value) => match {
        Value::CHAR(c) => println!("Value: {:x}", c),
        Value::BOOL(b) => println!("Yes") if b,
        Value::INT(i) => println!("Value: {}", i),
        Value::BITS(u) => println!("Value: 0x{:32b}", u),
        Value::FLOAT(f) | Value::DOUBLE(f) => println!("Value: {:.2}", f),
        _  => println!("Unknown Value")
    }
};  

Variants

CHAR(u8)

BOOL(bool)

INT(i32)

BITS(u32)

FLOAT(f32)

DOUBLE(f64)

UNKNOWN(())

IntVec(Vec<i32>)

FloatVec(Vec<f32>)

BoolVec(Vec<bool>)

Methods

impl Value

pub fn size(&self) -> usize

Trait Implementations

impl Clone for Value

fn clone(&self) -> Value

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Value

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Value

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl From<i32> for Value

fn from(v: i32) -> Value

Performs the conversion.

impl Into<Vec<bool>> for Value

fn into(self) -> Vec<bool>

Performs the conversion.

impl Into<bool> for Value

fn into(self) -> bool

Performs the conversion.

impl Serialize for Value

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.

impl TryInto<f32> for Value

type Error = &'static str

The type returned in the event of a conversion error.

fn try_into(self) -> Result<f32, Self::Error>

Performs the conversion.

impl TryInto<f64> for Value

type Error = &'static str

The type returned in the event of a conversion error.

fn try_into(self) -> Result<f64, Self::Error>

Performs the conversion.

impl TryInto<i32> for Value

type Error = &'static str

The type returned in the event of a conversion error.

fn try_into(self) -> Result<i32, Self::Error>

Performs the conversion.

impl TryInto<u32> for Value

type Error = &'static str

The type returned in the event of a conversion error.

fn try_into(self) -> Result<u32, Self::Error>

Performs the conversion.