Struct Query 

pub struct Query {
    pub user: Option<String>,
    pub hosts: Vec<String>,
    pub long: bool,
    pub port: u16,
}

A parsed finger query.

Represents the structured result of parsing a finger query string like "user@host", "@host", or "user@host1@host2".

Fields

user: Option<String>

The user to query. None means list all users.

hosts: Vec<String>

The host(s) to query. The last host is the connection target. Multiple hosts indicate a forwarding chain (RFC 1288).

long: bool

Whether to request verbose output (sends /W prefix).

port: u16

TCP port to connect on. Default is 79.

Implementations

impl Query

pub fn parse( input: Option<&str>, long: bool, port: u16, ) -> Result<Query, QueryError>

Parse a query string into a Query.

Returns an error if any hostname segment is empty (e.g. "user@", "user@@host").

Examples

use digit::query::Query;

// Standard user query
let q = Query::parse(Some("user@example.com"), false, 79).unwrap();
assert_eq!(q.user, Some("user".to_string()));
assert_eq!(q.target_host(), "example.com");

// Empty hostname is rejected
assert!(Query::parse(Some("user@"), false, 79).is_err());

pub fn target_host(&self) -> &str

Returns the host to connect to (the last host in the chain).

Trait Implementations

impl Clone for Query

fn clone(&self) -> Query

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Query

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

Formats the value using the given formatter.

impl PartialEq for Query

fn eq(&self, other: &Query) -> 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 StructuralPartialEq for Query