Struct hexchat_api::ThreadSafeContext

pub struct ThreadSafeContext { /* private fields */ }

A thread-safe version of Context. Its methods automatically execute on the Hexchat main thread. The full set of methods of Context aren’t fully implemented for this struct because some can’t be trusted to produce predictable results from other threads. For instance .set() from a thread would only cause Hexchat to momentarily set its context, but Hexchat’s context could change again at any moment while the other thread is executing.

Implementations

impl ThreadSafeContext

pub fn get() -> Result<Self, HexchatError>

Gets the user’s current Context wrapped in a ThreadSafeContext object.

pub fn find(network: &str, channel: &str) -> Result<Self, HexchatError>

Gets a ThreadSafeContext object associated with the given channel.

Arguments

• network - The network of the channel to get the context for.
• channel - The channel to get the context of.

Returns

• Ok(ThreadSafeContext) on success, and HexchatError on failure.

pub fn print(&self, message: &str) -> Result<(), HexchatError>

Prints the message to the ThreadSafeContext object’s Hexchat context. This is how messages can be printed to Hexchat windows apart from the currently active one.

pub fn aprint(&self, message: &str)

Prints without waiting for asynchronous completion. This will print faster than .print() because it just stacks up print requests in the timer queue and moves on without blocking. The downside is errors will not be checked. Error messages will, however, still be printed if any occur.

pub fn command(&self, command: &str) -> Result<(), HexchatError>

Issues a command in the context held by the ThreadSafeContext object.

pub fn get_info(&self, info: &str) -> Result<String, HexchatError>

Gets information from the channel/window that the ThreadSafeContext object holds an internal pointer to.

pub fn emit_print( &self, event_name: &str, var_args: &[&str] ) -> Result<(), HexchatError>

Issues a print event to the context held by the ThreadSafeContext object.

pub fn list_get( &self, name: &str ) -> Result<ThreadSafeListIterator, HexchatError>

Gets a ThreadSafeListIterator from the context. If the list doesn’t exist, or a problem occurs, an error will be returned.

pub fn network(&self) -> Result<String, HexchatError>

Returns the network name associated with the context.

pub fn channel(&self) -> Result<String, HexchatError>

Returns the channel name associated with the context.

Trait Implementations

impl Clone for ThreadSafeContext

fn clone(&self) -> ThreadSafeContext

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ThreadSafeContext

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

Formats the value using the given formatter.

impl Display for ThreadSafeContext

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

Formats the value using the given formatter.

impl Drop for ThreadSafeContext

fn drop(&mut self)

Executes the destructor for this type.

impl From<ThreadSafeFieldValue> for ThreadSafeContext

fn from(v: ThreadSafeFieldValue) -> Self

Converts to this type from the input type.

impl Send for ThreadSafeContext

impl Sync for ThreadSafeContext