(:capture)

captures a matched value to reference in (:replace) substitutions

(:capture name val?)

Where:

1. name: the name to reference this capture (used as $name) *
2. val: the value to capture *

Behavior

• Captured values are referenced in substitution strings using $name syntax.

Examples

Capture the first argument to prepend it elsewhere in a transformation.

(call process
  (arg 1
    (:and
      (:capture firstArg (str))
      (:replace _ ""before", $firstArg"))))

Selects in lines { 1 } but not in { }:

process("data")

---

Capture from one argument to use in replacing another argument.

(call fetch
  (:and
    (arg 1 (:capture endpoint (str)))
    (arg 2 (:replace _ "$endpoint_config"))))

Selects in lines { 1 } but not in { }:

fetch("/users", oldConfig)

---

Capture a list of nodes by using (:into) to span the entire range.

(:and
  (call log (arg 1 (:replace _ "$params")))
  (call log (arg 2.. (:capture params (:into)))))

Selects in lines { 1 } but not in { }:

log(first, second, third)

---

Use captured identifier name to generate a prefixed version.

(call bootstrap (arg 1 (:replace (id /(?<name>.+)/) "init_$name")))

Selects in lines { 1, 2 } but not in { }:

bootstrap(component)
bootstrap(service)

---

Arguments

name

• Identifier

Does NOT support: Composition — Free-form Selection — Refinement — Replacement

val

• inherit