Struct screeps::RoomName

pub struct RoomName { /* fields omitted */ }

A structure representing a room name.

Methods

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 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 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<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 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<&'_ 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 &'_ 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<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<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<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 Copy for RoomName

impl Eq for RoomName

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 Debug for RoomName

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

Formats the value using the given formatter.

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 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 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 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 JsSerialize for RoomName

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

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.

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<'_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 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 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<'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.