curryRight

将一个函数从右到左进行柯里化，允许它每次只用一个参数调用，并返回一个接受下一个参数的新函数。这个过程会继续，直到所有参数都已提供，此时将使用所有累积的参数调用原始函数。

这个方法类似于 curry，不同之处在于它从右到左对函数进行柯里化。

签名

function curryRight<R>(func: () => R): () => R;
function curryRight<P, R>(func: (p: P) => R): (p: P) => R;
function curryRight<P1, P2, R>(func: (p1: P1, p2: P2) => R): (p2: P2) => (p1: P1) => R;
function curryRight<P1, P2, P3, R>(func: (p1: P1, p2: P2, p3: P3) => R): (p3: P3) => (p2: P2) => (p1: P1) => R;
function curryRight<P1, P2, P3, P4, R>(
  func: (p1: P1, p2: P2, p3: P3, p4: P4) => R
): (p4: P4) => (p3: P3) => (p2: P2) => (p1: P1) => R;
function curryRight<P1, P2, P3, P4, P5, R>(
  func: (p1: P1, p2: P2, p3: P3, p4: P4, p5: P5) => R
): (p5: P5) => (p4: P4) => (p3: P3) => (p2: P2) => (p1: P1) => R;
function curryRight(func: (...args: any[]) => any): (...args: any[]) => any;

参数

• func ((...args: any[]) => any): 要进行柯里化的函数。

返回值

((...args: any[]) => any): 一个可以每次调用一个参数的柯里化函数。

示例

function sum(a: number, b: number, c: number) {
  return a + b + c;
}

const curriedSum = curryRight(sum);

// 参数 `c` 应该被赋值为 `10`。
const sum10 = curriedSum(10);

// 参数 `b` 应该被赋值为 `15`。
const sum25 = sum10(15);

// 参数 `a` 应该被赋值为 `5`。函数 'sum' 已经接收到了所有参数，现在将返回一个值。
const result = sum25(5); // 30

Lodash 兼容性

从 es-toolkit/compat 中导入 curryRight 以实现与 lodash 的完全兼容。

签名

function curryRight(
  func: (...args: any[]) => any,
  arity: number = func.length,
  guard?: unknown
): ((...args: any[]) => any) & { placeholder: typeof curryRight.placeholder };

namespace curryRight {
  placeholder: symbol;
}

• curryRight 接受一个额外的数值参数 arity，该参数指定了函数的参数数量。
  • 默认为 func.length，如果 arity 为负数或 NaN，则会被转换为 0。如果它是一个小数，则会被向下取整到最接近的整数。
• guard 使其可以用作 Array#map 等方法的迭代器。
• curryRight.placeholder 值默认为一个 symbol，可以用作部分应用参数的占位符。
• 不像原生的 curryRight，这个方法允许每次使用多个参数调用，并返回一个接受剩余参数的新函数。

示例

import { curryRight } from 'es-toolkit/compat';

const abc = function (a, b, c) {
  return [a, b, c];
};

const curried = curryRight(abc);

curried(3)(2)(1);
// => [1, 2, 3]

curried(2, 3)(1);
// => [1, 2, 3]

curried(1, 2, 3);
// => [1, 2, 3]

// Curried with placeholders.
curried(3)(curryRight.placeholder, 2)(1);
// => [1, 2, 3]

// Curried with arity.
curried = curryRight(abc, 2);

curried(2)(1);
// => [1, 2]