Struct screeps::RoomName

pub struct RoomName { /* fields omitted */ }

A structure representing a room name.

Ordering

To facilitate use as a key in a BTreeMap or other similar data structures, RoomName implements PartialOrd and Ord.

RoomNames are ordered first by y position, then by x position. North is considered less than south, and west less than east.

The total ordering is N127W127, N127W126, N127W125, ..., N127W0, N127E0, ..., N127E127, N126W127, ..., S127E126, S127E127.

This follows left-to-right reading order when looking at the Screeps map from above.

Implementations

impl RoomName

pub fn new<T: ?Sized>(x: &T) -> Result<Self, RoomNameParseError> where
    T: AsRef<str>, 

Parses a room name from a string.

This will parse the input string, returning an error if it is in an invalid room name.

The expected format can be represented by the regex [ewEW][0-9]+[nsNS][0-9]+.

pub fn to_array_string(&self) -> ArrayString<[u8; 8]>

Converts this RoomName into an efficient, stack-based string.

This is equivalent to ToString::to_string, but involves no allocation.

Trait Implementations

impl Add<(i32, i32)> for RoomName

type Output = Self

The resulting type after applying the + operator.

fn add(self, (x, y): (i32, i32)) -> Self

Offsets this room name by a given horizontal and vertical (x, y) pair.

The first number offsets to the west when negative and to the east when positive. The first number offsets to the north when negative and to the south when positive.

Panics

Will panic if the addition overflows the boundaries of RoomName.

impl Clone for RoomName

fn clone(&self) -> RoomName

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for RoomName

impl Debug for RoomName

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RoomName

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where
    D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Display for RoomName

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

Formats this room name into the format the game expects.

Resulting string will be (E|W)[0-9]+(N|S)[0-9]+, and will result in the same RoomName if passed into RoomName::new.

impl Eq for RoomName

impl FromStr for RoomName

type Err = RoomNameParseError

The associated error which can be returned from parsing.

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

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

impl Hash for RoomName

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, 

Feeds a slice of this type into the given [Hasher].

impl JsSerialize for RoomName

fn _into_js<'x>(&'x self) -> SerializedValue<'x>

impl JsSerializeOwned for RoomName

fn into_js_owned<'_a>(value: &'_a mut Option<Self>) -> SerializedValue<'_a>

impl<'_r> JsSerializeOwned for &'_r RoomName

fn into_js_owned<'_a>(value: &'_a mut Option<Self>) -> SerializedValue<'_a>

impl Ord for RoomName

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

This method returns an [Ordering] between self and other.

#[must_use]fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]fn clamp(self, min: Self, max: Self) -> Self

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

Restrict a value to a certain interval.

impl<'_> PartialEq<&'_ String> for RoomName

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'_> PartialEq<&'_ str> for RoomName

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialEq<RoomName> for RoomName

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl PartialEq<RoomName> for str

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'_> PartialEq<RoomName> for &'_ str

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialEq<RoomName> for String

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'_> PartialEq<RoomName> for &'_ String

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialEq<String> for RoomName

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialEq<str> for RoomName

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialOrd<RoomName> for RoomName

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

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

#[must_use]fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use]fn le(&self, other: &Rhs) -> bool

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

#[must_use]fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]fn ge(&self, other: &Rhs) -> bool

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

impl Serialize for RoomName

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error> where
    S: Serializer, 

Serialize this value into the given Serde serializer.

impl StructuralEq for RoomName

impl StructuralPartialEq for RoomName

impl Sub<(i32, i32)> for RoomName

type Output = Self

The resulting type after applying the - operator.

fn sub(self, (x, y): (i32, i32)) -> Self

Offsets this room name in the opposite direction from the coordinates.

See the implementation for Add<(i32, i32)>.

Panics

Will panic if the subtraction overflows the boundaries of RoomName.

impl Sub<RoomName> for RoomName

type Output = (i32, i32)

The resulting type after applying the - operator.

fn sub(self, other: RoomName) -> (i32, i32)

Subtracts one room name from the other, extracting the difference.

The first return value represents east/west offset, with 'more east' being positive and 'more west' being negative.

The second return value represents north/south offset, with 'more south' being positive and 'more north' being negative.

This coordinate system agrees with the implementations Add<(i32, i32)> for RoomName and Sub<(i32, i32)> for RoomName.

impl<'_a> TryFrom<&'_a RoomName> for Value

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: &'_a RoomName) -> Result<Self, Self::Error>

Performs the conversion.

impl<'_a> TryFrom<&'_a mut RoomName> for Value

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: &'_a mut RoomName) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<RoomName> for Value

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: RoomName) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Value> for RoomName

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: Value) -> Result<Self, Self::Error>

Performs the conversion.