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. Borrowed tags retain their input slice, while normalized tags retain their owned backing string.

Implementations

impl<'a> RawTags<'a>

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

Creates RawTags from a borrowed tag block.

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’s 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 fn from_owned( raw_tags: String, max_tag_count: usize, max_tag_len: usize, ) -> Self

Creates RawTags from an owned, normalized tag block.

pub const fn empty() -> Self

Creates an empty RawTags.

pub fn iter(&self) -> RawTagsIter<'_>

Returns an iterator over the individual tags.

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.