Struct easy_ffi_wrapper::StrBuilder

pub struct StrBuilder {
    pub ptr: *const c_char,
    pub len: usize,
}

A convenience structure for calling FFI interfaces to get strings

Example

use easy_ffi::{Str, StrBuilder};

enum T {}

extern "C" {
    fn extern_get_str_from_my_struct(
        t: *const T,
        ptr_out: *mut *const c_char,
        len_out: *mut usize,
    );
}

impl T {
    fn get_str(&self) -> Str {
        let mut builder = StrBuilder::new();
        unsafe {
            extern_get_str_from_my_struct(self, &mut builder.ptr, &mut builder.len);
            builder.build()
        }
    }
}

Fields

ptr: *const c_char

Pointer to the first character of the string to fill in, usually as an output parameter.

len: usize

Len of the string to fill in, usually as an output parameter.

Implementations

impl StrBuilder

pub fn new() -> Self

Creates a new builder referencing an empty string.

pub unsafe fn build<'a, 'b>(&'a self) -> Str<'b>

Construct a string from ptr + len.

No terminating \0 required, and invalid UTF8 possible.

Safety

Same as slice_from_raw_parts with self.ptr and self.len as parameters.

Trait Implementations

impl Debug for StrBuilder

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

Formats the value using the given formatter.

impl Default for StrBuilder

fn default() -> Self

Returns the “default value” for a type.