Method pop_front

src/pointer.rs:974–988

Removes and returns the first `Token` in the `Pointer` if it exists.

(&mut self)

    /// Removes and returns the first `Token` in the `Pointer` if it exists.
    pub fn pop_front(&mut self) -> Option<Token<'static>> {
        (!self.is_root()).then(|| {
            // if not root, must contain at least one `/`
            let mut token = if let Some(idx) = self.0[1..].find('/') {
                let token = self.0.split_off(idx + 1);
                core::mem::replace(&mut self.0, token)
            } else {
                core::mem::take(&mut self.0)
            };
            // remove leading `/`
            token.remove(0);
            // SAFETY: source pointer is encoded
            unsafe { Token::from_encoded_unchecked(token) }
        })
    }

    /// Merges two `Pointer`s by appending `other` onto `self`.
    pub fn append<P: AsRef<Pointer>>(&mut self, other: P) -> &PointerBuf {