Struct XHandle 

pub struct XHandle(/* private fields */);

An X handle (aka username).

Contains 1–20 ASCII letters, digits, or underscores. MAX_LENGTH is the compatibility ceiling: current X usernames are limited to 15 characters, but legacy accounts include handles longer than that, such as @richardrushfield (16 characters). Parsing drops one optional @. Spelling is preserved, while equality, ordering, and hashing ignore ASCII case.

Legacy compatibility

X’s current help page specifies 15 characters. Twitter’s archived 2010 and 2016 help pages also describe that limit, but the 2010 page explicitly preserves longer “early bird” usernames without publishing their hard upper bound. This type uses the historically reported 20-character compatibility ceiling and covers the known 16-character richardrushfield account. Longer inputs are rejected, never truncated.

use known_types_x::XHandle;

let legacy: XHandle = "@richardrushfield".parse()?;
assert_eq!(legacy.as_str(), "richardrushfield");
assert!(legacy.as_str().len() > XHandle::CURRENT_MAX_LENGTH);

See the shared handle contract and crate-level integration recipes. With async-graphql, the scalar is named XHandle.

Implementations

impl XHandle

pub const MIN_LENGTH: usize = 1

Minimum length of the normalized handle, in Unicode scalar values.

pub const MAX_LENGTH: usize = 20

Maximum representational length, in Unicode scalar values.

This is the widest known current or historical upstream bound, not necessarily the current registration limit.

pub fn as_str(&self) -> &str

Borrow the validated, normalized handle.

pub fn into_string(self) -> String

Consume the handle and return its stored spelling.

impl XHandle

pub const CURRENT_MAX_LENGTH: usize = 15

Current X username maximum for new registrations and edits.

pub const HISTORICAL_MAX_LENGTH: usize = 20

Historical compatibility maximum used by legacy Twitter accounts.

Trait Implementations

impl AsRef<String> for XHandle

fn as_ref(&self) -> &String

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<str> for XHandle

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for XHandle

fn clone(&self) -> XHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for XHandle

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

Formats the value using the given formatter.

impl Display for XHandle

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

Formats the value using the given formatter.

impl Eq for XHandle

impl FromStr for XHandle

type Err = ParseHandleError

The associated error which can be returned from parsing.

fn from_str(input: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for XHandle

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for XHandle

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for XHandle

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for XHandle

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl TryFrom<&str> for XHandle

type Error = ParseHandleError

The type returned in the event of a conversion error.

fn try_from(input: &str) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<String> for XHandle

type Error = ParseHandleError

The type returned in the event of a conversion error.

fn try_from(input: String) -> Result<Self, Self::Error>

Performs the conversion.