Struct uuid::fmt::Hyphenated
source · pub struct Hyphenated(/* private fields */);
Expand description
Format a Uuid
as a hyphenated string, like
67e55044-10b1-426f-9247-bb680e5fe0c8
.
Implementations§
source§impl 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§
source§impl AsRef<Uuid> for Hyphenated
impl AsRef<Uuid> for Hyphenated
source§impl Borrow<Uuid> for Hyphenated
impl Borrow<Uuid> for Hyphenated
source§impl Clone for Hyphenated
impl Clone for Hyphenated
source§fn clone(&self) -> Hyphenated
fn clone(&self) -> Hyphenated
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for Hyphenated
impl Debug for Hyphenated
source§impl Default for Hyphenated
impl Default for Hyphenated
source§fn default() -> Hyphenated
fn default() -> Hyphenated
source§impl Display for Hyphenated
impl Display for Hyphenated
source§impl From<Hyphenated> for Uuid
impl From<Hyphenated> for Uuid
source§fn from(f: Hyphenated) -> Self
fn from(f: Hyphenated) -> Self
source§impl From<Uuid> for Hyphenated
impl From<Uuid> for Hyphenated
source§impl Hash for Hyphenated
impl Hash for Hyphenated
source§impl LowerHex for Hyphenated
impl LowerHex for Hyphenated
source§impl Ord for Hyphenated
impl Ord for Hyphenated
source§fn cmp(&self, other: &Hyphenated) -> Ordering
fn cmp(&self, other: &Hyphenated) -> Ordering
1.21.0 · source§fn max(self, other: Self) -> Selfwhere
Self: Sized,
fn max(self, other: Self) -> Selfwhere
Self: Sized,
source§impl PartialEq for Hyphenated
impl PartialEq for Hyphenated
source§fn eq(&self, other: &Hyphenated) -> bool
fn eq(&self, other: &Hyphenated) -> bool
self
and other
values to be equal, and is used
by ==
.source§impl PartialOrd for Hyphenated
impl PartialOrd for Hyphenated
source§fn partial_cmp(&self, other: &Hyphenated) -> Option<Ordering>
fn partial_cmp(&self, other: &Hyphenated) -> Option<Ordering>
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 moresource§impl Serialize for Hyphenated
impl Serialize for Hyphenated
source§impl UpperHex for Hyphenated
impl UpperHex for Hyphenated
impl Copy for Hyphenated
impl Eq for Hyphenated
impl StructuralPartialEq for Hyphenated
Auto Trait Implementations§
impl Freeze for Hyphenated
impl RefUnwindSafe for Hyphenated
impl Send for Hyphenated
impl Sync for Hyphenated
impl Unpin for Hyphenated
impl UnwindSafe for Hyphenated
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
)