Package: org.codehaus.groovy.runtime

## [Java] Class CurriedClosure<V>

- org.codehaus.groovy.runtime.CurriedClosure

-     public final class CurriedClosure<V>
      extends Closure

  A wrapper for Closure to support currying. Normally used only internally through the `curry()`, `rcurry()` or `ncurry()` methods on `Closure`.

  Typical usages:

       // normal usage
       def unitAdder = { first, second, unit -> "${first + second} $unit" }
       assert unitAdder(10, 15, "minutes") == "25 minutes"
       assert unitAdder.curry(60)(15, "minutes") == "75 minutes"
       def minuteAdder = unitAdder.rcurry("minutes")
       assert minuteAdder(15, 60) == "75 minutes"

       // explicit creation
       import org.codehaus.groovy.runtime.CurriedClosure
       assert new CurriedClosure(unitAdder, 45)(15, "minutes") == "60 minutes"
       assert new CurriedClosure(unitAdder, "six", "ty")("minutes") == "sixty minutes"

  Notes:
  - Caters for Groovy's lazy (rcurry) and eager (ncurry) calculation of argument position

- - Inherited fields
    Fields inherited from class | Fields
    --- | ---
    `class Closure` | `DELEGATE_FIRST, DELEGATE_ONLY, DONE, IDENTITY, OWNER_FIRST, OWNER_ONLY, TO_SELF, maximumNumberOfParameters, parameterTypes`

  - ### Constructor Summary

    Constructors
    Constructor and description
    `CurriedClosure(int index, Closure<V> uncurriedClosure, Object arguments)` Parameters: `index` - the position where the parameters should be injected (-ve for lazy)
    `CurriedClosure(Closure<V> uncurriedClosure, Object arguments)`

  - ### Methods Summary

    Methods
    Type Params | Return Type | Name and description
    --- | --- | ---
    `` | `public V` | `call(Object argument)` Fast path for the dominant rcurry/curry shape — one curried argument and a single incoming argument against a binary owner.
    `` | `public Object` | `clone()`
    `` | `public Object` | `getDelegate()`
    `` | `public Closure<V>` | `getOwner()`
    `` | `public Class[]` | `getParameterTypes()`
    `` | `public int` | `getResolveStrategy()`
    `` | `public Object[]` | `getUncurriedArguments(Object arguments)`
    `` | `public void` | `setDelegate(Object delegate)`
    `` | `public void` | `setResolveStrategy(int resolveStrategy)`

  - ### Inherited Methods Summary

    Inherited Methods
    Methods inherited from class | Name
    --- | ---
    `class Closure` | `additionalReferences, andThen, andThenSelf, andThenSelf, asWritable, call, call, call, checkForReferenceCycle, clone, compose, composeSelf, composeSelf, curry, curry, dehydrate, getDelegate, getDirective, getMaximumNumberOfParameters, getOwner, getParameterTypes, getProperty, getResolveStrategy, getThisObject, isCase, leftShift, leftShift, memoize, memoizeAtLeast, memoizeAtMost, memoizeBetween, mopUnperturbed, ncurry, ncurry, rcurry, rcurry, rehydrate, rightShift, run, setDelegate, setDirective, setMetaClass, setProperty, setResolveStrategy, throwRuntimeException, trampoline, trampoline`
    `class GroovyObjectSupport` | `getMetaClass, setMetaClass`

- - ### Constructor Detail

    - #### public CurriedClosure(int index, Closure<V> uncurriedClosure, Object arguments)

      Parameters:
        `index` - the position where the parameters should be injected (-ve for lazy)
        `uncurriedClosure` - the closure to be called after the curried parameters are injected
        `arguments` - the supplied parameters

    - #### @GroovyABI(since = "1.0.0")
      public CurriedClosure(Closure<V> uncurriedClosure, Object arguments)

  - ### Method Detail

    - #### public V call(Object argument)

      Fast path for the dominant rcurry/curry shape — one curried argument and a single incoming argument against a binary owner. Skips the wrapping `Object[1]` that Closure.call would otherwise allocate before dispatch, leaving just the one combined `Object[2]` that the underlying call already requires.

    - #### public Object clone()

    - #### public Object getDelegate()

    - #### public Closure<V> getOwner()

    - #### public Class[] getParameterTypes()

    - #### public int getResolveStrategy()

    - #### public Object[] getUncurriedArguments(Object arguments)

    - #### public void setDelegate(Object delegate)

    - #### public void setResolveStrategy(int resolveStrategy)