Struct RawTags 

pub struct RawTags<'a> { /* private fields */ }

A wrapper over raw tags in their unprocessed form.

This type is meant to handle raw tags that have been extracted from network payloads, such as DogStatsD, where the input byte slice contains the tags – whether bare or key/value – packed together and separated by commas (,, 0x2C) character.

RawTags supports iteration over these tags in an efficient, zero-copy fashion and returns string references to each individual tag. It supports configuration to control how many tags can be returned, and the maximum allowable length for a tag. This allows easy usage where limits must be enforced, without having to write additional code to filter the resulting iterator.

Cloning

RawTags can be cloned to create a new iterator with its own iteration state. The same underlying input byte slice is retained.

Implementations

impl<'a> RawTags<'a>

pub const fn new( raw_tags: &'a str, max_tag_count: usize, max_tag_len: usize, ) -> Self

Creates a new RawTags from the given input byte slice.

The maximum tag count and maximum tag length control how many tags are returned from the iterator and their length. If the iterator encounters more tags than the maximum count, it will simply stop returning tags. If the iterator encounters any tag that is longer than the maximum length, it will truncate the tag to configured length, or to a smaller length, whichever is closer to a valid UTF-8 character boundary.

pub const fn empty() -> Self

Creates an empty RawTags.

Trait Implementations

impl<'a> Clone for RawTags<'a>

fn clone(&self) -> RawTags<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> IntoIterator for RawTags<'a>

type Item = &'a str

The type of the elements being iterated over.

type IntoIter = RawTagsIter<'a>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.