Struct uuid::fmt::Hyphenated
source · [−]#[repr(transparent)]pub struct Hyphenated(_);
Expand description
Format a Uuid
as a hyphenated string, like
67e55044-10b1-426f-9247-bb680e5fe0c8
.
Implementations
sourceimpl Hyphenated
impl Hyphenated
sourcepub const fn from_uuid(uuid: Uuid) -> Self
pub const fn from_uuid(uuid: Uuid) -> Self
Creates a Hyphenated
from a Uuid
.
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 hyphenated 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.hyphenated()
.encode_lower(&mut Uuid::encode_buffer()),
"936da01f-9abd-4d9d-80c7-02af85c822a8"
);
// the buffer is mutated directly, and trailing contents remains
let mut buf = [b'!'; 40];
uuid.hyphenated().encode_lower(&mut buf);
assert_eq!(
&buf as &[_],
b"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 hyphenated 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.hyphenated()
.encode_upper(&mut Uuid::encode_buffer()),
"936DA01F-9ABD-4D9D-80C7-02AF85C822A8"
);
// the buffer is mutated directly, and trailing contents remains
let mut buf = [b'!'; 40];
uuid.hyphenated().encode_upper(&mut buf);
assert_eq!(
&buf as &[_],
b"936DA01F-9ABD-4D9D-80C7-02AF85C822A8!!!!" as &[_]
);
Ok(())
}
*/
Trait Implementations
sourceimpl AsRef<Uuid> for Hyphenated
impl AsRef<Uuid> for Hyphenated
sourceimpl Borrow<Uuid> for Hyphenated
impl Borrow<Uuid> for Hyphenated
sourceimpl Clone for Hyphenated
impl Clone for Hyphenated
sourcefn clone(&self) -> Hyphenated
fn clone(&self) -> Hyphenated
Returns a copy of the value. Read more
1.0.0 · sourcefn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source
. Read more
sourceimpl Debug for Hyphenated
impl Debug for Hyphenated
sourceimpl Default for Hyphenated
impl Default for Hyphenated
sourcefn default() -> Hyphenated
fn default() -> Hyphenated
Returns the “default value” for a type. Read more
sourceimpl Display for Hyphenated
impl Display for Hyphenated
sourceimpl From<Hyphenated> for Uuid
impl From<Hyphenated> for Uuid
sourcefn from(f: Hyphenated) -> Self
fn from(f: Hyphenated) -> Self
Converts to this type from the input type.
sourceimpl From<Uuid> for Hyphenated
impl From<Uuid> for Hyphenated
sourceimpl Hash for Hyphenated
impl Hash for Hyphenated
sourceimpl LowerHex for Hyphenated
impl LowerHex for Hyphenated
sourceimpl Ord for Hyphenated
impl Ord for Hyphenated
sourceimpl PartialEq<Hyphenated> for Hyphenated
impl PartialEq<Hyphenated> for Hyphenated
sourcefn eq(&self, other: &Hyphenated) -> bool
fn eq(&self, other: &Hyphenated) -> bool
This method tests for self
and other
values to be equal, and is used
by ==
. Read more
sourcefn ne(&self, other: &Hyphenated) -> bool
fn ne(&self, other: &Hyphenated) -> bool
This method tests for !=
.
sourceimpl PartialOrd<Hyphenated> for Hyphenated
impl PartialOrd<Hyphenated> for Hyphenated
sourcefn partial_cmp(&self, other: &Hyphenated) -> Option<Ordering>
fn partial_cmp(&self, other: &Hyphenated) -> 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
sourceimpl Serialize for Hyphenated
impl Serialize for Hyphenated
sourceimpl UpperHex for Hyphenated
impl UpperHex for Hyphenated
impl Copy for Hyphenated
impl Eq for Hyphenated
impl StructuralEq for Hyphenated
impl StructuralPartialEq for Hyphenated
Auto Trait Implementations
impl RefUnwindSafe for Hyphenated
impl Send for Hyphenated
impl Sync for Hyphenated
impl Unpin for Hyphenated
impl UnwindSafe for Hyphenated
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