io.cucumber.cucumberexpressions.CaptureGroupTransformer Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of cucumber-expressions Show documentation

Cucumber Expressions are simple patterns for matching Step Definitions with Gherkin steps

There is a newer version: 18.0.1

package io.cucumber.cucumberexpressions;

import org.apiguardian.api.API;

/**
 * Transformer for a @{@link ParameterType} with (multiple) capture groups.
 *
 * @param  the type to transform to.
 */
@API(status = API.Status.STABLE)
@FunctionalInterface
public interface CaptureGroupTransformer {
    /**
     * Transforms multiple strings into to an object. The strings are taken from
     * the capture groups in the regular expressions in order. Nested capture
     * groups are ignored. If a capture group is optional the corresponding element
     * in the array may be null.
     *
     * @param args the values of the top level capture groups
     * @return the transformed object
     * @throws Throwable if transformation failed
     */
    T transform(String[] args) throws Throwable;
}