Skip to main content

Translit

devela::zall

Struct Translit 

Source 
pub struct Translit;
Expand description

๐“ ๐Ÿ› ๏ธ Lossy text transliteration utilities.

Provides small, mostly const mappings from Unicode scalars to simpler textual approximations.

๐Ÿ“ text

Implementationsยง

Sourceยง

impl Translit

Source

pub const fn ascii(char: char) -> &'static str โ“˜

Available on crate feature translit only.

Returns the ASCII transliteration of a Unicode scalar value.

This is a lossy transliteration, not an encoding. The result may contain zero, one, or more ASCII bytes.

Returns an empty string if the scalar is not mapped.

Converts Unicode to readable ASCII approximations:

  • 'ยฐ' โ†’ "deg"
  • 'ฮฑ' โ†’ "a"
  • 'ยฉ' โ†’ "(c)"
  • 'ไธญ' โ†’ "Zhong "
  • '๐Ÿš€' โ†’ ""
  • โ€ฆ
Source

pub const fn ascii_scalar(scalar: u32) -> &'static str โ“˜

Available on crate feature translit only.

Returns the ASCII transliteration of a Unicode scalar code point.

This accepts a raw u32 for table-oriented use. Invalid or unmapped scalar values simply return an empty string.

ยงVendored

This is adapted work from transliteration.

Source

pub fn ascii_of<S: UnicodeScalar>(scalar: S) -> &'static str โ“˜

Available on crate feature translit only.

Returns an ASCII approximation of any Unicode scalar type.

Source

pub const fn has_ascii(c: char) -> bool

Available on crate feature translit only.

Returns whether the scalar has a non-empty ASCII approximation.

Source

pub const fn has_ascii_scalar(scalar: u32) -> bool

Available on crate feature translit only.

Returns whether the scalar code point has a non-empty ASCII approximation.

Source

pub const fn ascii_or(c: char, fallback: &'static str) -> &'static str โ“˜

Available on crate feature translit only.

Returns an ASCII approximation, or fallback if the scalar is unmapped.

Source

pub const fn ascii_scalar_or( scalar: u32, fallback: &'static str, ) -> &'static str โ“˜

Available on crate feature translit only.

Returns an ASCII approximation, or fallback if the scalar is unmapped.

Source

pub const fn ascii_byte(c: char) -> Option<u8> โ“˜

Available on crate feature translit only.

Returns the single ASCII byte approximation, if it is exactly one byte.

Source

pub const fn ascii_scalar_byte(scalar: u32) -> Option<u8> โ“˜

Available on crate feature translit only.

Returns the single ASCII byte approximation, if it is exactly one byte.

Source

pub const fn ascii_len(c: char) -> usize

Available on crate feature translit only.

Returns the length of the ASCII approximation.

Source

pub const fn ascii_scalar_len(scalar: u32) -> usize

Available on crate feature translit only.

Returns the length of the ASCII approximation.

Sourceยง

impl Translit

Source

pub fn write_ascii(src: &str, dst: &mut [u8]) -> Option<usize> โ“˜

Available on crate feature translit only.

Writes the ASCII approximation of src into dst.

Unmapped scalars are omitted.

Returns the number of bytes written, or None if dst is too small.

Source

pub fn write_ascii_or( src: &str, dst: &mut [u8], fallback: &str, ) -> Option<usize> โ“˜

Available on crate feature translit only.

Writes the ASCII approximation of src into dst, using fallback for unmapped scalars.

Returns the number of bytes written, or None if dst is too small.

Trait Implementationsยง

Sourceยง

impl Debug for Translit

Sourceยง

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

Auto Trait Implementationsยง

Blanket Implementationsยง

Sourceยง

impl<T> Any for T
where T: 'static + ?Sized,

Sourceยง

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Sourceยง

impl<T> AnyExt for T
where T: Any + ?Sized,

Sourceยง

fn type_id() -> TypeId

Returns the TypeId of Self. Read more
Sourceยง

fn type_of(&self) -> TypeId

Returns the TypeId of self. Read more
Sourceยง

fn type_name(&self) -> &'static str โ“˜

Returns the type name of self. Read more
Sourceยง

fn type_is<T: 'static>(&self) -> bool

Returns true if Self is of type T. Read more
Sourceยง

fn type_hash(&self) -> u64

Returns a deterministic hash of the TypeId of Self.
Sourceยง

fn type_hash_with<H: Hasher>(&self, hasher: H) -> u64

Returns a deterministic hash of the TypeId of Self using a custom hasher.
Sourceยง

fn as_any_ref(&self) -> &dyn Any
where Self: Sized,

Upcasts &self as &dyn Any. Read more
Sourceยง

fn as_any_mut(&mut self) -> &mut dyn Any
where Self: Sized,

Upcasts &mut self as &mut dyn Any. Read more
Sourceยง

fn as_any_box(self: Box<Self>) -> Box<dyn Any>
where Self: Sized,

Available on crate feature alloc only.
Upcasts Box<self> as Box<dyn Any>. Read more
Sourceยง

fn downcast_ref<T: 'static>(&self) -> Option<&T> โ“˜

Available on crate feature unsafe_layout and non-crate feature safe_code only.
Returns some shared reference to the inner value if it is of type T. Read more
Sourceยง

fn downcast_mut<T: 'static>(&mut self) -> Option<&mut T> โ“˜

Available on crate feature unsafe_layout and non-crate feature safe_code only.
Returns some exclusive reference to the inner value if it is of type T. Read more
Sourceยง

impl<T> Borrow<T> for T
where T: ?Sized,

Sourceยง

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Sourceยง

impl<T> BorrowMut<T> for T
where T: ?Sized,

Sourceยง

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Sourceยง

impl<T> ByteSized for T

Sourceยง

const BYTE_ALIGN: usize = _

The alignment of this type in bytes.
Sourceยง

const BYTE_SIZE: usize = _

The size of this type in bytes.
Sourceยง

fn byte_align(&self) -> usize

Returns the alignment of this type in bytes.
Sourceยง

fn byte_size(&self) -> usize

Returns the size of this type in bytes. Read more
Sourceยง

fn ptr_size_ratio(&self) -> [usize; 2]

Returns the size ratio between Ptr::BYTES and BYTE_SIZE. Read more
Sourceยง

impl<T> From<T> for T

Sourceยง

fn from(t: T) -> T

Returns the argument unchanged.

Sourceยง

impl<T> Hook for T

Sourceยง

fn hook<F>(self, f: F) -> Self
where F: FnOnce(&mut Self),

Hooks a mutation step into the value and returns it. Read more
Sourceยง

fn tap<F>(self, f: F) -> Self
where F: FnOnce(&Self),

Taps into the value for observation and returns it unchanged. Read more
Sourceยง

impl<T, U> Into<U> for T
where U: From<T>,

Sourceยง

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Sourceยง

impl<T> MemExt for T
where T: ?Sized,

Sourceยง

const NEEDS_DROP: bool = _

Know whether dropping values of this type matters, in compile-time.
Sourceยง

fn mem_align_of<T>() -> usize

Returns the minimum alignment of the type in bytes. Read more
Sourceยง

fn mem_align_of_val(&self) -> usize

Returns the alignment of the pointed-to value in bytes. Read more
Sourceยง

fn mem_size_of<T>() -> usize

Returns the size of a type in bytes. Read more
Sourceยง

fn mem_size_of_val(&self) -> usize

Returns the size of the pointed-to value in bytes. Read more
Sourceยง

fn mem_copy(&self) -> Self
where Self: Copy,

Bitwise-copies a value. Read more
Sourceยง

fn mem_needs_drop(&self) -> bool

Returns true if dropping values of this type matters. Read more
Sourceยง

fn mem_drop(self)
where Self: Sized,

Drops self by running its destructor. Read more
Sourceยง

fn mem_forget(self)
where Self: Sized,

Forgets about self without running its destructor. Read more
Sourceยง

fn mem_replace(&mut self, other: Self) -> Self
where Self: Sized,

Replaces self with other, returning the previous value of self. Read more
Sourceยง

fn mem_take(&mut self) -> Self
where Self: Default,

Replaces self with its default value, returning the previous value of self. Read more
Sourceยง

fn mem_swap(&mut self, other: &mut Self)
where Self: Sized,

Swaps the value of self and other without deinitializing either one. Read more
Sourceยง

unsafe fn mem_zeroed<T>() -> T

Available on crate feature unsafe_layout only.
Returns the value of type T represented by the all-zero byte-pattern. Read more
Sourceยง

unsafe fn mem_transmute_copy<Src, Dst>(src: &Src) -> Dst

Available on crate feature unsafe_layout only.
Returns the value of type T represented by the all-zero byte-pattern. Read more
Sourceยง

fn mem_as_bytes(&self) -> &[u8] โ“˜
where Self: Sync + Unpin,

Available on crate feature unsafe_slice only.
View a Sync + Unpin self as &[u8]. Read more
Sourceยง

fn mem_as_bytes_mut(&mut self) -> &mut [u8] โ“˜
where Self: Sync + Unpin,

Available on crate feature unsafe_slice only.
View a Sync + Unpin self as &mut [u8]. Read more
Sourceยง

impl<T, R> Morph<R> for T
where T: ?Sized,

Sourceยง

fn morph<F>(self, f: F) -> R
where F: FnOnce(Self) -> R, Self: Sized,

Morphs the value into a new one and returns it. Read more
Sourceยง

fn morph_ref<F>(&self, f: F) -> R
where F: FnOnce(&Self) -> R,

Morphs the value by shared reference and returns the result. Read more
Sourceยง

fn morph_mut<F>(&mut self, f: F) -> R
where F: FnOnce(&mut Self) -> R,

Morphs the value by exclusive reference and returns the result. Read more
Sourceยง

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Sourceยง

type Error = Infallible

The type returned in the event of a conversion error.
Sourceยง

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error> โ“˜

Performs the conversion.
Sourceยง

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Sourceยง

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Sourceยง

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error> โ“˜

Performs the conversion.