Struct ServiceTag 

pub struct ServiceTag { /* private fields */ }

Available on crate feature icap only.

A validated, unquoted ICAP service tag.

Quotes and backslashes are escaped when the value is encoded, so callers work only with the logical in-memory value.

Implementations

impl ServiceTag

pub const fn new(value: &str) -> Result<ServiceTag, InvalidServiceTag>

Validate a service-tag value of at most 32 bytes.

pub const fn from_static(value: &'static str) -> ServiceTag

Construct a service tag for use in a const or static declaration.

Invalid literals fail const evaluation, so users do not need a manual match merely to define a known service tag.

use rama_icap::proto::ServiceTag;

const TAG: ServiceTag = ServiceTag::from_static("rama-icap-example");
assert_eq!(TAG.as_str(), "rama-icap-example");

use rama_icap::proto::ServiceTag;

const TAG: ServiceTag = ServiceTag::from_static("123456789012345678901234567890123");

pub fn as_str(&self) -> &str

Return the unquoted in-memory service-tag token.

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

Return the unquoted logical service-tag bytes.

pub const fn to_wire(self) -> EncodedServiceTag

Encode this tag for a raw ICAP header field.

High-level server and OPTIONS APIs do this automatically. This wrapper is only needed when constructing a raw crate::codec::Header.

Trait Implementations

impl Clone for ServiceTag

fn clone(&self) -> ServiceTag

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ServiceTag

impl Debug for ServiceTag

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

Formats the value using the given formatter.

impl Display for ServiceTag

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

Formats the value using the given formatter.

impl Eq for ServiceTag

impl Hash for ServiceTag

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ServiceTag

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ServiceTag