#arguments #bind #binding

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

#1896 in Rust patterns

Download history 253/week @ 2025-10-19 233/week @ 2025-10-26 182/week @ 2025-11-02 212/week @ 2025-11-09 167/week @ 2025-11-16 193/week @ 2025-11-23 255/week @ 2025-11-30 193/week @ 2025-12-07 252/week @ 2025-12-14 179/week @ 2025-12-21 171/week @ 2025-12-28 371/week @ 2026-01-04 285/week @ 2026-01-11 360/week @ 2026-01-18 498/week @ 2026-01-25 276/week @ 2026-02-01

1,445 downloads per month
Used in 13 crates (10 directly)

MIT/Apache

11KB
122 lines

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.


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)
    );
}

No runtime deps