Struct c_ffi::args::Args

pub struct Args { /* fields omitted */ }

Wrapper over C-style arguments

Example:

On most targets you can supply own C-style main function.

One of the benefits is that it is no longer necessary to rely on allocating std::env::Args

#![no_main]

#[no_mangle]
unsafe extern "C" fn main(argc: isize, argv: *const *const u8) -> isize {
    let args = c_ffi::Args::new(argc, argv).expect("To get function arguments");

    0
}

Methods

impl Args

pub unsafe fn new(
    argc: isize,
    argv: *const *const u8
) -> Result<Self, (usize, Utf8Error)>

Creates new instance, but verifies that each string inside are UTF-8.

On error returns pair: (string index, Utf8Error)

The function is safe as long as you pass C style main function arguments.

pub unsafe fn new_unchecked(argc: isize, argv: *const *const u8) -> Self

Unchecked version of Args::new

Do it on your own risk

pub fn as_slice(&self) -> &[*const u8]

Returns slice of raw C strings

pub unsafe fn get_str_by_index(&self, index: usize) -> &str

Retrieves string by index.

No checks, 100% unsafe.

Trait Implementations

impl<'a> IntoIterator for &'a Args

type Item = &'a str

The type of the elements being iterated over.

type IntoIter = IntoIter<'a>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl Copy for Args

impl Clone for Args

fn clone(&self) -> Args

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.