Struct libpulse_glib_binding::Mainloop

pub struct Mainloop {
    pub _inner: Rc<MainloopInner<MainloopInternal>>,
}

This acts as a safe interface to the internal PA Mainloop.

The mainloop object pointers are further enclosed here in a ref counted wrapper, allowing this outer wrapper to have clean methods for creating event objects, which can cleanly pass a copy of the inner ref counted mainloop object to them. Giving this to events serves two purposes, firstly because they need the API pointer, secondly, it ensures that event objects do not outlive the mainloop object.

Fields

_inner: Rc<MainloopInner<MainloopInternal>>

The ref-counted inner data.

Implementations

impl Mainloop

pub fn new(context: Option<&mut MainContext>) -> Option<Self>

Creates a new GLIB main loop object for the specified GLIB main loop context.

Takes an argument context for the glib::MainContext to use. If context is None the default context is used.

This returns the object in an Rc wrapper, allowing multiple references to be held, which allows event objects to hold one, thus ensuring they do not outlive it.

pub fn get_api<'a>(&self) -> &'a MainloopApi

Gets the abstract main loop abstraction layer vtable for this main loop.

No need to free the API as it is owned by the loop and is destroyed when the loop is freed.

Talking to PA directly with C requires fetching this pointer explicitly via this function. This is actually unnecessary through this binding. The pointer is retrieved automatically upon Mainloop creation, stored internally, and automatically obtained from it by functions that need it.

Trait Implementations

impl Mainloop for Mainloop

type MI = MainloopInner<MainloopInternal>

pub fn inner(&self) -> Rc<MainloopInner<MainloopInternal>>

pub fn new_io_event(
    &mut self,
    fd: i32,
    events: u32,
    callback: Box<dyn FnMut(IoEventRef<Self::MI>, i32, u32) + 'static, Global>
) -> Option<IoEvent<Self::MI>>

Creates a new IO event.

pub fn new_timer_event(
    &mut self,
    tv: &UnixTs,
    callback: Box<dyn FnMut(TimeEventRef<Self::MI>) + 'static, Global>
) -> Option<TimeEvent<Self::MI>>

Creates a new timer event.

pub fn new_timer_event_rt(
    &mut self,
    t: MonotonicTs,
    callback: Box<dyn FnMut(TimeEventRef<Self::MI>) + 'static, Global>
) -> Option<TimeEvent<Self::MI>>

Creates a new monotonic-based timer event.

pub fn new_deferred_event(
    &mut self,
    callback: Box<dyn FnMut(DeferEventRef<Self::MI>) + 'static, Global>
) -> Option<DeferEvent<Self::MI>>

Creates a new deferred event.

pub fn once_event(&mut self, callback: Box<dyn FnMut() + 'static, Global>)

Runs the specified callback once from the main loop using an anonymous defer event.

pub fn quit(&mut self, retval: Retval)

Calls quit

impl MainloopSignals for Mainloop

pub fn init_signals(&mut self) -> Result<(), PAErr>

Initializes the UNIX signal subsystem and bind it to the specified main loop.

pub fn signals_done(&self)

Cleans up the signal subsystem.