Struct PortalAddress 

pub struct PortalAddress { /* private fields */ }

A 12-glyph portal address encoding a galactic location.

Each glyph is a nibble (0-15), and the 12 glyphs form a 48-bit packed value in the same layout as GalacticAddress: P-SSS-YY-ZZZ-XXX.

Implementations

impl PortalAddress

pub fn new(glyphs: [u8; 12]) -> Self

Create from an array of 12 u8 values (each 0-15).

pub fn glyph(&self, i: usize) -> Glyph

Get the glyph at position i (0-11).

pub fn glyphs(&self) -> [Glyph; 12]

Get all 12 glyphs.

pub fn to_hex_string(&self) -> String

Format as 12 hex digits (uppercase): e.g., 01717D8A4EA2.

pub fn to_emoji_string(&self) -> String

Format as emoji string.

pub fn parse_mixed(s: &str) -> Result<Self, PortalParseError>

Parse a mixed-format string containing 12 glyphs.

Accepts any combination of hex digits, emoji, and glyph names.

pub fn to_galactic_address(&self) -> GalacticAddress

Convert to GalacticAddress (reality_index = 0).

pub fn from_galactic_address(addr: &GalacticAddress) -> Self

Create from a GalacticAddress.

pub fn from_signal_booster( s: &str, planet_index: u8, reality_index: u8, ) -> Result<Self, AddressParseError>

Create from a signal booster string by first parsing to GalacticAddress.

Trait Implementations

impl Clone for PortalAddress

fn clone(&self) -> PortalAddress

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PortalAddress

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PortalAddress

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for PortalAddress

Default display is hex.

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

Formats the value using the given formatter.

impl From<GalacticAddress> for PortalAddress

fn from(addr: GalacticAddress) -> Self

Convert galactic address to portal address.

Extracts each nibble from the packed 48-bit value.

impl From<PortalAddress> for GalacticAddress

fn from(pa: PortalAddress) -> Self

Convert portal address to galactic address.

Portal glyph layout: P-SSS-YY-ZZZ-XXX (glyph positions 0-indexed: [0]=P, [1-3]=SSS, [4-5]=YY, [6-8]=ZZZ, [9-11]=XXX). Reality index defaults to 0.

impl FromStr for PortalAddress

Parse from any supported format (hex, emoji, mixed).

type Err = PortalParseError

The associated error which can be returned from parsing.

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

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

impl Hash for PortalAddress

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 PartialEq for PortalAddress

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for PortalAddress

impl Eq for PortalAddress

impl StructuralPartialEq for PortalAddress