Struct KeyPos 

pub struct KeyPos { /* private fields */ }

Position record for one parsed key.

The full key bytes live in key. When a hash tag is configured and the tag delimiters are present in the key, tag indexes the range inside key that should be hashed for routing; otherwise tag covers the whole key and is equal to 0..key.len().

Examples

use dynomite::msg::keypos::KeyPos;

let kp = KeyPos::without_tag(b"user:42".to_vec());
assert_eq!(kp.key(), b"user:42");
assert_eq!(kp.tag_bytes(), b"user:42");

Implementations

impl KeyPos

pub fn new(key: Vec<u8>, tag: Range<usize>) -> Self

Build a KeyPos with an explicit tag sub-range.

Panics if tag.end > key.len() or tag.start > tag.end.

Examples

use dynomite::msg::keypos::KeyPos;
let kp = KeyPos::new(b"{abc}xyz".to_vec(), 1..4);
assert_eq!(kp.tag_bytes(), b"abc");

pub fn without_tag(key: Vec<u8>) -> Self

Build a KeyPos whose tag covers the entire key.

Examples

use dynomite::msg::keypos::KeyPos;
let kp = KeyPos::without_tag(b"hello".to_vec());
assert_eq!(kp.tag_bytes(), b"hello");

pub fn key(&self) -> &[u8]

Borrow the full key bytes.

pub fn key_len(&self) -> usize

Length of the full key in bytes.

pub fn tag(&self) -> Range<usize>

Borrow the tag range.

pub fn tag_bytes(&self) -> &[u8]

Borrow the tag bytes.

pub fn tag_len(&self) -> usize

Length of the tag in bytes.

Trait Implementations

impl Clone for KeyPos

fn clone(&self) -> KeyPos

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for KeyPos

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

Formats the value using the given formatter.

impl Eq for KeyPos

impl PartialEq for KeyPos

fn eq(&self, other: &KeyPos) -> 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 StructuralPartialEq for KeyPos