pub struct UrnRef<'a>(_);
Implementations
sourceimpl<'a> UrnRef<'a>
impl<'a> UrnRef<'a>
sourcepub const fn from_uuid_ref(uuid: &'a Uuid) -> Self
pub const fn from_uuid_ref(uuid: &'a Uuid) -> Self
sourcepub fn encode_lower<'buf>(&self, buffer: &'buf mut [u8]) -> &'buf mut str
pub fn encode_lower<'buf>(&self, buffer: &'buf mut [u8]) -> &'buf mut str
Writes the Uuid
as a lower-case URN string to
buffer
, and returns the subslice of the buffer that contains the
encoded UUID.
This is slightly more efficient than using the formatting infrastructure as it avoids virtual calls, and may avoid double buffering.
Panics
Panics if the buffer is not large enough: it must have length at least
LENGTH
. Uuid::encode_buffer
can be used to get a
sufficiently-large temporary buffer.
Examples
use uuid::Uuid;
fn main() -> Result<(), uuid::Error> {
let uuid = Uuid::parse_str("936DA01f9abd4d9d80c702af85c822a8")?;
// the encoded portion is returned
assert_eq!(
uuid.to_urn().encode_lower(&mut Uuid::encode_buffer()),
"urn:uuid:936da01f-9abd-4d9d-80c7-02af85c822a8"
);
// the buffer is mutated directly, and trailing contents remains
let mut buf = [b'!'; 49];
uuid.to_urn().encode_lower(&mut buf);
assert_eq!(
uuid.to_urn().encode_lower(&mut buf),
"urn:uuid:936da01f-9abd-4d9d-80c7-02af85c822a8"
);
assert_eq!(
&buf as &[_],
b"urn:uuid:936da01f-9abd-4d9d-80c7-02af85c822a8!!!!" as &[_]
);
Ok(())
}
*/
sourcepub fn encode_upper<'buf>(&self, buffer: &'buf mut [u8]) -> &'buf mut str
pub fn encode_upper<'buf>(&self, buffer: &'buf mut [u8]) -> &'buf mut str
Writes the Uuid
as an upper-case URN string to
buffer
, and returns the subslice of the buffer that contains the
encoded UUID.
This is slightly more efficient than using the formatting infrastructure as it avoids virtual calls, and may avoid double buffering.
Panics
Panics if the buffer is not large enough: it must have length at least
LENGTH
. Uuid::encode_buffer
can be used to get a
sufficiently-large temporary buffer.
Examples
use uuid::Uuid;
fn main() -> Result<(), uuid::Error> {
let uuid = Uuid::parse_str("936da01f9abd4d9d80c702af85c822a8")?;
// the encoded portion is returned
assert_eq!(
uuid.to_urn().encode_upper(&mut Uuid::encode_buffer()),
"urn:uuid:936DA01F-9ABD-4D9D-80C7-02AF85C822A8"
);
// the buffer is mutated directly, and trailing contents remains
let mut buf = [b'!'; 49];
assert_eq!(
uuid.to_urn().encode_upper(&mut buf),
"urn:uuid:936DA01F-9ABD-4D9D-80C7-02AF85C822A8"
);
assert_eq!(
&buf as &[_],
b"urn:uuid:936DA01F-9ABD-4D9D-80C7-02AF85C822A8!!!!" as &[_]
);
Ok(())
}
*/
Trait Implementations
sourceimpl<'a> Hash for UrnRef<'a>
impl<'a> Hash for UrnRef<'a>
sourcefn hash<__H: Hasher>(&self, state: &mut __H)
fn hash<__H: Hasher>(&self, state: &mut __H)
Hasher
]. Read more1.3.0fn hash_slice<H>(data: &[Self], state: &mut H)where
H: Hasher,
fn hash_slice<H>(data: &[Self], state: &mut H)where
H: Hasher,
Hasher
]. Read moresourceimpl<'a> Ord for UrnRef<'a>
impl<'a> Ord for UrnRef<'a>
sourceimpl<'a> PartialOrd<UrnRef<'a>> for UrnRef<'a>
impl<'a> PartialOrd<UrnRef<'a>> for UrnRef<'a>
sourcefn partial_cmp(&self, other: &UrnRef<'a>) -> Option<Ordering>
fn partial_cmp(&self, other: &UrnRef<'a>) -> Option<Ordering>
1.0.0const fn lt(&self, other: &Rhs) -> bool
const fn lt(&self, other: &Rhs) -> bool
1.0.0const fn le(&self, other: &Rhs) -> bool
const fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read more