Struct ObjectId

pub struct ObjectId<T> { /* private fields */ }

Represents an Object ID and a type that the ID points to, stored in Rust memory.

Use JsObjectId if a reference stored in JavaScript memory is preferred.

Each object ID in Screeps: World is represented by an ID of up to 24 hexidemical characters, which cannot change. This implementation takes advantage of that by storing a packed representation in a u128, using 96 bits for the ID and 32 bits for tracking the length of the ID string for reconstruction in JS.

Conversion

Use into to convert between ObjectId<T> and RawObjectId, and ObjectId::into_type to change the type this ObjectId points to freely.

Ordering

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

ObjectId’s are ordered by the corresponding order of their underlying byte values. This agrees with:

• lexicographical ordering of the object id strings
• JavaScript’s ordering of object id strings
• ordering of RawObjectIds

Note: when running on the official screeps server, or on a private server backed by a MongoDB database, this ordering roughly corresponds to creation order. The first four bytes of a MongoDB-created ObjectId are seconds since the epoch when the id was created, so up to a second accuracy, these ids will be sorted by object creation time.

Implementations

impl<T> ObjectId<T>

pub fn into_type<U>(self) -> ObjectId<U>

Changes the type this ObjectId points to, unchecked.

This will allow changing to any type - ObjectId makes no guarantees about its ID matching the type of any object in the game that it actually points to.

pub fn from_packed(packed: u128) -> Self

Creates an object ID from its packed representation.

The input to this function is the bytes representing the up-to-24 hex digits in the object id.

See also RawObjectId::from_packed.

pub fn to_u128(self) -> u128

Converts this object ID to a u128 number.

The returned number, when formatted as hex, will produce a string parseable into this object id.

The returned number will be less than or equal to 2^96 - 1, as that’s the maximum value that RawObjectId can hold.

pub fn to_array_string(&self) -> ArrayString<24>

Formats this object ID as a string on the stack.

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

See also RawObjectId::to_array_string.

pub fn try_resolve(self) -> Result<Option<T>, RoomObject>

where T: MaybeHasId + JsCast,

Resolves this object ID into an object, verifying that the returned object matches the expected type.

Errors

Will return an error if this ID’s type does not match the object it points to with the resolved RoomObject with an unknown type.

Will return Ok(None) if the object no longer exists, or is in a room we don’t have vision for.

pub fn resolve(self) -> Option<T>

where T: MaybeHasId + JsCast,

Resolves this ID into an object, assuming the type T is the correct type of object that this ID refers to. If the ID has been converted to an invalid type, using the returned object in a way not valid for its type will cause a panic.

Will return None if this object no longer exists, or is in a room we don’t have vision for.

Trait Implementations

impl<T> Clone for ObjectId<T>

fn clone(&self) -> ObjectId<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> Debug for ObjectId<T>

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

Formats the value using the given formatter.

impl<'de, T> Deserialize<'de> for ObjectId<T>

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T> Display for ObjectId<T>

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

Formats the value using the given formatter.

impl<T> From<ObjectId<T>> for ArrayString<24>

fn from(id: ObjectId<T>) -> Self

Converts to this type from the input type.

impl<T> From<ObjectId<T>> for RawObjectId

fn from(id: ObjectId<T>) -> Self

Converts to this type from the input type.

impl<T> From<ObjectId<T>> for String

fn from(id: ObjectId<T>) -> Self

Converts to this type from the input type.

impl<T> From<ObjectId<T>> for u128

fn from(id: ObjectId<T>) -> Self

Converts to this type from the input type.

impl<T> From<RawObjectId> for ObjectId<T>

fn from(raw: RawObjectId) -> Self

Converts to this type from the input type.

impl<T> From<u128> for ObjectId<T>

fn from(packed: u128) -> Self

Converts to this type from the input type.

impl<T> FromStr for ObjectId<T>

type Err = RawObjectIdParseError

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<T> Hash for ObjectId<T>

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<T> JsCollectionFromValue for ObjectId<T>

fn from_value(val: JsValue) -> Self

impl<T> Ord for ObjectId<T>

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.

impl<T> PartialEq<ObjectId<T>> for RawObjectId

fn eq(&self, other: &ObjectId<T>) -> 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<T> PartialEq<RawObjectId> for ObjectId<T>

fn eq(&self, other: &RawObjectId) -> 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<T> PartialEq for ObjectId<T>

fn eq(&self, o: &ObjectId<T>) -> 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<T> PartialOrd<ObjectId<T>> for RawObjectId

fn partial_cmp(&self, other: &ObjectId<T>) -> 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<T> PartialOrd<RawObjectId> for ObjectId<T>

fn partial_cmp(&self, other: &RawObjectId) -> 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<T> PartialOrd for ObjectId<T>

fn partial_cmp(&self, other: &ObjectId<T>) -> 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<T> Serialize for ObjectId<T>

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<T> Copy for ObjectId<T>

impl<T> Eq for ObjectId<T>