Struct ChannelTimetable 

#[non_exhaustive]
pub struct ChannelTimetable {
    pub profile_created: Option<i64>,
    pub created: Option<i64>,
    pub answered: Option<i64>,
    pub progress: Option<i64>,
    pub progress_media: Option<i64>,
    pub hungup: Option<i64>,
    pub transferred: Option<i64>,
    pub resurrected: Option<i64>,
    pub bridged: Option<i64>,
    pub last_hold: Option<i64>,
    pub hold_accum: Option<i64>,
}

Channel timing data from FreeSWITCH’s switch_channel_timetable_t.

Timestamps are epoch microseconds (i64). A value of 0 means the corresponding event never occurred (e.g., hungup == Some(0) means the channel has not hung up yet). None means the header was absent or unparseable.

Extracted from ESL event headers using a prefix (typically "Caller" or "Other-Leg"). The wire header format is {prefix}-{suffix}.

Headers extracted

from_lookup() extracts headers with suffixes from SUFFIXES. With TimetablePrefix::Caller, extracts Caller-Channel-Created-Time → created, Caller-Channel-Hangup-Time → hungup, etc.

Use TimetablePrefix::OtherLeg for Other-Leg-* headers, TimetablePrefix::Channel for outbound ESL Channel-* headers, or pass a custom string prefix to from_lookup(). See SUFFIXES for the complete list.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

profile_created: Option<i64>

When the caller profile was created.

created: Option<i64>

When the channel was created.

answered: Option<i64>

When the channel was answered.

progress: Option<i64>

When early media (183) was received.

progress_media: Option<i64>

When media-bearing early media arrived.

hungup: Option<i64>

When the channel hung up.

transferred: Option<i64>

When the channel was transferred.

resurrected: Option<i64>

When the channel was resurrected.

bridged: Option<i64>

When the channel was bridged.

last_hold: Option<i64>

Timestamp of the last hold event.

hold_accum: Option<i64>

Accumulated hold time in microseconds.

Implementations

impl ChannelTimetable

pub const SUFFIXES: &'static [&'static str]

Header suffixes extracted by from_lookup().

Combine with a TimetablePrefix to build full header names for event subscriptions or filters:

use freeswitch_types::{ChannelTimetable, TimetablePrefix};

let prefix = TimetablePrefix::Caller.as_str();
let headers: Vec<String> = ChannelTimetable::SUFFIXES
    .iter()
    .map(|suffix| format!("{prefix}-{suffix}"))
    .collect();
assert!(headers.contains(&"Caller-Channel-Created-Time".to_string()));

pub fn from_lookup<'a>( prefix: impl AsRef<str>, lookup: impl Fn(&str) -> Option<&'a str>, ) -> Result<Option<Self>, ParseTimetableError>

Extract a timetable by looking up prefixed header names via a closure.

The closure receives full header names (e.g. "Caller-Channel-Created-Time") and should return the raw value if present. Works with any key-value store: HashMap<String, String>, EslEvent, BTreeMap, etc.

Returns Ok(None) if no timestamp headers with this prefix are present. Returns Err if a header is present but contains an invalid (non-i64) value.

use std::collections::HashMap;
use freeswitch_types::{ChannelTimetable, TimetablePrefix};

let mut headers: HashMap<String, String> = HashMap::new();
headers.insert("Caller-Channel-Created-Time".into(), "1700000001000000".into());

// With enum:
let tt = ChannelTimetable::from_lookup(TimetablePrefix::Caller, |k| headers.get(k).map(|v: &String| v.as_str()));
assert!(tt.unwrap().unwrap().created.is_some());

// With raw string (e.g. for dynamic "Call-1" prefix):
let tt = ChannelTimetable::from_lookup("Caller", |k| headers.get(k).map(|v: &String| v.as_str()));
assert!(tt.unwrap().unwrap().created.is_some());

Trait Implementations

impl Clone for ChannelTimetable

fn clone(&self) -> ChannelTimetable

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ChannelTimetable

impl Debug for ChannelTimetable

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

Formats the value using the given formatter.

impl Default for ChannelTimetable

fn default() -> ChannelTimetable

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ChannelTimetable

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ChannelTimetable

impl PartialEq for ChannelTimetable

fn eq(&self, other: &ChannelTimetable) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ChannelTimetable

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ChannelTimetable