Convenient implementation of function
currying and partial application.

• Installation
• Usage
  • Left currying
  • Right currying
  • Partial application
• Api
  • Functions
  • Methods of the curried function

Library can be installed into any PHP application:

• Using Composer dependency manager
• The Force for the Jedi Developers

$ composer require phpfn/curry

In order to access library make sure to include vendor/autoload.php
in your file.

<?php

require __DIR__ . '/vendor/autoload.php';

The left currying can be perceived as adding arguments to an array.
And then applying this array of arguments to the function.

The left currying returns the partially applied function
from the first argument.

$fn = \curry(function($a, $b) { return $a + $b; });

$fn(3);      // ($a = 3) + ($b = ?)
$fn(3)(4);   // ($a = 3) + ($b = 4)

At the same time, right-hand currying can be
perceived as adding arguments to the right.

$fn = \rcurry(function($a, $b) { return $a + $b; });

$fn(3);      // ($a = ?) + ($b = 3)
$fn(3)(4);   // ($a = 4) + ($b = 3)

Partial application is when you can specify completely
random arguments, skipping unnecessary using placeholder _.

$fn = \curry(function($a, $b, $c) { return $a + $b * $c; });

$fn = $fn(_, 3, 4); // ($a = ?)  + ($b = 3) * ($c = 4)
echo  $fn(42);      // ($a = 42) + ($b = 3) * ($c = 4)

$fn = \curry(function($a, $b, $c) { return $a + $b * $c; });

$fn = $fn(_, 3, _); // ($a = ?)  + ($b = 3) * ($c = ?)
$fn->lcurry(42);    // ($a = 42) + ($b = 3) * ($c = ?)
$fn->rcurry(23);    // ($a = ?)  + ($b = 3) * ($c = 23)

$fn = \curry(function($a, $b, $c) { return $a + $b * $c; });

$sum  = $fn(7, 9);    // 7 + 9 * ?
$sum(6);              // 7 + 9 * 6 

$mul  = $fn(_, 7, 9); // ? + 7 * 9
$mul(6);              // 6 + 7 * 9

$test = $fn(_, 7, _); // ? + 7 * ?
$test(6);             // 6 + 7 * ? 

$test = $fn(_, 7);    // ? + 7 * ?
$test->rcurry(6);     // ? + 7 * 6 

• lcurry(callable $fn, ...$args): Curried or curry

Left currying (like array_push arguments)

• rcurry(callable $fn, ...$args): Curried

Right currying

• uncurry(callable $fn): mixed

Returns result or partially applied function

• $fn->__invoke(...$args) or $fn(...$args)

The magic method that allows an object to a callable type

• $fn->lcurry(...$args)

A method that returns a new function with left currying

• $fn->rcurry(...$args)

A method that returns a new function with right currying

• $fn->reduce()

Reduction of the composition of functions. Those. bringing the function to a single value – the result of this function.

• $fn->uncurry()

An attempt is made to reduce, or bring the function to another, which will return the result

• $fn->__toString()

Just a function dump