#binding #argument #bind #parameters

no-std partial_application

partial function application via the partial! macro

3 unstable releases

Uses old Rust 2015

0.2.1 Jul 30, 2020
0.2.0 Sep 23, 2019
0.1.0 Feb 26, 2018

#646 in Rust patterns

Download history 417/week @ 2024-06-17 438/week @ 2024-06-24 308/week @ 2024-07-01 409/week @ 2024-07-08 397/week @ 2024-07-15 490/week @ 2024-07-22 438/week @ 2024-07-29 388/week @ 2024-08-05 366/week @ 2024-08-12 392/week @ 2024-08-19 402/week @ 2024-08-26 332/week @ 2024-09-02 186/week @ 2024-09-09 248/week @ 2024-09-16 147/week @ 2024-09-23 181/week @ 2024-09-30

780 downloads per month
Used in 12 crates (9 directly)

MIT/Apache

11KB
122 lines

partial_application

The partial! macro allows for partial application of a function.

partial!(some_fn => arg0, _, arg2, _) returns the closure |x1, x3| some_fn(arg0, x1, arg2, x3).
Move closures are created by adding move in front of the function: partial!(move ..)

use partial_application::partial;

// When you're using the 2015 edition of Rust, you need to import the macro like this
#[macro_use]
extern crate partial_application;

fn foo(a: i32, b: i32, c: i32, d: i32, mul: i32, off: i32) -> i32 {
    (a + b*b + c.pow(3) + d.pow(4)) * mul - off
}

fn main() {
    let bar = partial!(foo => _, _, 10, 42, 10, 10);
    assert_eq!(
        foo(15, 15, 10, 42, 10, 10),
        bar(15, 15)
    );
}

lib.rs:

The partial! macro allows for partial application of a function.

partial!(some_fn => arg0, _, arg2, _) returns the closure |x1, x3| some_fn(arg0, x1, arg2, x3).
Move closures are created by adding move in front of the function: partial!(move ..)

#[macro_use]
extern crate partial_application;

fn foo(a: i32, b: i32, c: i32, d: i32, mul: i32, off: i32) -> i32 {
    (a + b*b + c.pow(3) + d.pow(4)) * mul - off
}

fn main() {
    let bar = partial!(foo => _, _, 10, _, 10, 10);
    assert_eq!(
        foo(15, 15, 10, 42, 10, 10),
        bar(15, 15,     42)
    );
}

The expressions used to fix an argument are reevaluated on every call of the new function because of the straightforward translation behind the macro.

#
fn identity(x: u32) -> u32 { x }

let mut n = 0;
let mut f = partial!(identity => { n += 1; n});
assert_eq!(f(), 1);
assert_eq!(f(), 2);

Pre-compute arguments to be fixed in a local variable, if their creation is expensive or has unwanted side-effects.

You can also use a comma (,) or semicolon (;) instead of the arrow (=>). This strange syntax choice is due to limitations imposed on us by the macro system. No other tokens may follow the expression token for the function.

No runtime deps