pub struct Urn(/* private fields */);
Expand description
Format a Uuid
as a URN string, like
urn:uuid:67e55044-10b1-426f-9247-bb680e5fe0c8
.
Implementations§
source§impl 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§
source§impl Ord for Urn
impl Ord for Urn
source§impl PartialOrd for Urn
impl PartialOrd for Urn
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moreimpl Copy for Urn
impl Eq for Urn
impl StructuralPartialEq for Urn
Auto Trait Implementations§
impl Freeze for Urn
impl RefUnwindSafe for Urn
impl Send for Urn
impl Sync for Urn
impl Unpin for Urn
impl UnwindSafe for Urn
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> CloneToUninit for Twhere
T: Copy,
impl<T> CloneToUninit for Twhere
T: Copy,
source§unsafe fn clone_to_uninit(&self, dst: *mut T)
unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
source§default unsafe fn clone_to_uninit(&self, dst: *mut T)
default unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)