#[repr(transparent)]pub struct Urn(_);
Expand description
Format a Uuid
as a URN string, like
urn:uuid:67e55044-10b1-426f-9247-bb680e5fe0c8
.
Implementations
sourceimpl Urn
impl Urn
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.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.urn().encode_lower(&mut buf);
assert_eq!(
uuid.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.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.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 Ord for Urn
impl Ord for Urn
sourceimpl PartialOrd<Urn> for Urn
impl PartialOrd<Urn> for Urn
sourcefn partial_cmp(&self, other: &Urn) -> Option<Ordering>
fn partial_cmp(&self, other: &Urn) -> Option<Ordering>
This method returns an ordering between self
and other
values if one exists. Read more
1.0.0 · sourcefn lt(&self, other: &Rhs) -> bool
fn lt(&self, other: &Rhs) -> bool
This method tests less than (for self
and other
) and is used by the <
operator. Read more
1.0.0 · sourcefn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
impl Copy for Urn
impl Eq for Urn
impl StructuralEq for Urn
impl StructuralPartialEq for Urn
Auto Trait Implementations
impl RefUnwindSafe for Urn
impl Send for Urn
impl Sync for Urn
impl Unpin for Urn
impl UnwindSafe for Urn
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more