Struct Chat 

pub struct Chat {
    pub rowid: i32,
    pub chat_identifier: String,
    pub service_name: Option<String>,
    pub display_name: Option<String>,
    pub is_filtered: Option<i32>,
    pub is_blackholed: Option<bool>,
    pub is_pending_review: Option<bool>,
}

Row from the chat table.

Fields

rowid: i32

Chat row ID.

chat_identifier: String

Phone number, email, or group chat identifier.

service_name: Option<String>

Service name stored for the chat.

display_name: Option<String>

User-provided chat display name.

is_filtered: Option<i32>

Raw conversation-list tier from chat.is_filtered, used to build the ChatFilterStatus via Self::filter_status.

is_blackholed: Option<bool>

Raw chat.is_blackholed flag: 1 denotes a chat whose incoming messages are silently dropped.

is_pending_review: Option<bool>

Raw chat.is_pending_review flag: 1 denotes a filtered chat awaiting review.

Implementations

impl Chat

pub fn get(db: &Connection) -> Result<CachedStatement<'_>, TableError>

Prepare the SELECT * statement for the chat table.

pub fn by_rowid(db: &Connection) -> Result<HashMap<i32, Chat>, TableError>

Map chat rows by row ID.

One conversation may have several chat row IDs. Call crate::tables::chat_handle::ChatToHandle::dedupe after caching the participant sets and handle groups.

Example:

use imessage_database::util::dirs::default_db_path;
use imessage_database::tables::table::get_connection;
use imessage_database::tables::chat::Chat;

let db_path = default_db_path().unwrap();
let conn = get_connection(&db_path).unwrap();
let chatrooms = Chat::by_rowid(&conn);

impl Chat

pub fn name(&self) -> &str

Return the display name, falling back to the chat identifier.

pub fn display_name(&self) -> Option<&str>

Return the non-empty custom display name.

pub fn service(&self) -> Service<'_>

Return the chat service as a Service.

pub fn filter_status(&self) -> Option<ChatFilterStatus>

Parse the conversation-list tier from Self::is_filtered.

A raw 0 maps to ChatFilterStatus::Unfiltered. None remains None, and every unrecognized value maps to ChatFilterStatus::Unknown.

pub fn properties(&self, db: &Connection) -> Option<Properties>

Parse Properties from the chat’s plist blob.

Calling this reads a BLOB from the database.

Trait Implementations

impl Debug for Chat

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

Formats the value using the given formatter.

impl Table for Chat

fn from_row(row: &Row<'_>) -> Result<Chat>

Deserialize a single row into Self. Returns rusqlite::Result for direct use inside rusqlite::query_map / query_row callbacks. For high-level iteration, prefer Table::rows or Table::row.

fn rows<'stmt, P: Params>( stmt: &'stmt mut Statement<'_>, params: P, ) -> Result<impl Iterator<Item = Result<Self, TableError>> + 'stmt, TableError>

where Self: 'stmt,

Iterate over the results of stmt, deserializing each row through from_row. Return TableError for both fetch and deserialization failures. Pass either a rusqlite::Statement or a rusqlite::CachedStatement (via deref coercion).

fn row<P: Params>( stmt: &mut Statement<'_>, params: P, ) -> Result<Self, TableError>

Fetch exactly one row from stmt. Returns TableError::QueryError if the row is missing or fails to deserialize. Accepts both rusqlite::Statement and rusqlite::CachedStatement (the latter via deref coercion).