Struct glib::char::Char
[−]
[src]
pub struct Char(pub c_char);
Wrapper for values where C functions expect a plain C char
Consider the following C function prototype from glib:
void g_key_file_set_list_separator (GKeyFile *key_file, gchar separator);
This function plainly expects a byte as the separator
argument. However,
having this function exposed to Rust as the following would be inconvenient:
impl KeyFile { pub fn set_list_separator(&self, separator: libc:c_char) { } }
This would be inconvenient because users would have to do the conversion from a Rust char
to an libc::c_char
by hand, which is just a type alias
for i8
on most system.
This Char
type is a wrapper over an libc::c_char
, so that we can pass it to Glib or C functions.
The check for whether a Rust char
(a Unicode scalar value) actually fits in a libc::c_char
is
done in the new
function; see its documentation for details.
The inner libc::c_char
(which is equivalent to i8
can be extracted with .0
, or
by calling my_char.to_glib()
.
Methods
impl Char
[src]
pub fn new(c: char) -> Option<Char>
[src]
Creates a Some(Char)
if the given char
is representable as an libc::c_char
Example
extern "C" fn have_a_byte(b: libc::c_char); let a = Char::new('a').unwrap(); assert!(a.0 == 65); have_a_byte(a.to_glib()); let not_representable = Char::new('☔'); assert!(not_representable.is_none());
Trait Implementations
impl Debug for Char
[src]
fn fmt(&self, __arg_0: &mut Formatter) -> Result
[src]
Formats the value using the given formatter. Read more
impl Copy for Char
[src]
impl Clone for Char
[src]
fn clone(&self) -> Char
[src]
Returns a copy of the value. Read more
fn clone_from(&mut self, source: &Self)
1.0.0[src]
Performs copy-assignment from source
. Read more
impl Eq for Char
[src]
impl PartialEq for Char
[src]
fn eq(&self, __arg_0: &Char) -> bool
[src]
This method tests for self
and other
values to be equal, and is used by ==
. Read more
fn ne(&self, __arg_0: &Char) -> bool
[src]
This method tests for !=
.