Skip to main content

Object

Struct Object 

Source
pub struct Object { /* private fields */ }
Expand description

A JSON object: string keys to Values, with keys kept the way a JS object keeps its properties.

Keys are in JS property order: integer-like keys (array indices, such as "0" and "10", but not "01") first in ascending numeric order, then the others in the order they were first set. This is the order Object.keys and JSON.stringify use.

Setting a key that is already there replaces its value and keeps its place, as assigning to an existing property does in JS. Two objects are equal when they have the same keys with equal values, in any order.

The keys are kept apart from the values, in a list that objects with the same keys in the same order can share: the rows of a table share one, the table’s layout, as JS engines’ hidden classes do, so reading a row’s column reaches its value without touching a copy of the column’s name. Cloning an object is cheap: copies share their values until one of them is changed.

Implementations§

Source§

impl Object

Source

pub fn new() -> Self

Source

pub fn with_capacity(_capacity: usize) -> Self

An empty object. Its values are allocated once it has keys, so the capacity isn’t used.

Source

pub fn len(&self) -> usize

Source

pub fn is_empty(&self) -> bool

Source

pub fn get(&self, key: &str) -> Option<&Value>

Source

pub fn get_mut(&mut self, key: &str) -> Option<&mut Value>

Source

pub fn contains_key(&self, key: &str) -> bool

Source

pub fn insert(&mut self, key: impl Into<String>, value: Value) -> Option<Value>

Sets key to value, returning the value it replaced. A new key goes after the others, or among the integer-like keys in numeric order.

Source

pub fn remove(&mut self, key: &str) -> Option<Value>

Removes key, returning its value. The other keys keep their order.

Source

pub fn iter(&self) -> Iter<'_, Value> ⓘ

The entries, in order.

Source

pub fn keys( &self, ) -> impl DoubleEndedIterator<Item = &String> + ExactSizeIterator + Clone

Source

pub fn values( &self, ) -> impl DoubleEndedIterator<Item = &Value> + ExactSizeIterator + Clone

Source

pub fn get_index(&self, index: usize) -> Option<(&String, &Value)>

The entry at index, in order.

Trait Implementations§

Source§

impl Clone for Object

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Object

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for Object

Source§

fn default() -> Self

An empty object, which allocates nothing.

Source§

impl From<Object> for Value

Source§

fn from(o: Object) -> Self

Converts to this type from the input type.
Source§

impl<K: Into<String>> FromIterator<(K, Value)> for Object

Source§

fn from_iter<I: IntoIterator<Item = (K, Value)>>(iter: I) -> Self

A key that repeats keeps its first place and its last value, as in a JS object literal.

Source§

impl<'a> IntoIterator for &'a Object

Source§

type Item = (&'a String, &'a Value)

The type of the elements being iterated over.
Source§

type IntoIter = Iter<'a, Value>

Which kind of iterator are we turning this into?
Source§

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value. Read more
Source§

impl IntoIterator for Object

Source§

type Item = (String, Value)

The type of the elements being iterated over.
Source§

type IntoIter = IntoIter<Value>

Which kind of iterator are we turning this into?
Source§

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value. Read more
Source§

impl PartialEq for Object

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more

Auto Trait Implementations§

§

impl Forget for Object

§

impl Freeze for Object

§

impl Move for Object

§

impl RefUnwindSafe for Object

§

impl Send for Object

§

impl Sync for Object

§

impl Unpin for Object

§

impl UnsafeUnpin for Object

§

impl UnwindSafe for Object

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.