# libasm

This is a library to provide inline assembly support for stable Rust.

All that is required to add inline assembly to a project is to create a build script similar to this:

```rust
extern crate libasm;

fn main() {
    libasm::parse();
}
```

[This is an example project:](https://github.com/coder543/asmtest)

```rust
#[macro_use]
extern crate libasm;

lasm! {
    "x86_64-unknown-linux-gnu"
    fn add2 {
        mov %rax, %rdi
        add %rax, %rsi
    }

    "x86_64-pc-windows-msvc"
    fn add2 {
        mov rax, rcx
        add rax, rdx
    }
}

extern "C" {
    fn add2(a: u64, b: u64) -> u64;
}

fn main() {
    let x = unsafe { add2(3, 4) };
    println!("Hello, world! 3 + 4 = {}", x);
}
```

A `lasm!` declaration provides a list of target-triple specific assembly functions. It is required to declare your own prototype for the function, as shown here after the `lasm!` block. If the target-triple being compiled for does not have a matching declaration, you will encounter a linker error unless the implementation comes from somewhere else.