Jawk in Java

Start with Awk

Create an Awk instance directly for normal use:

Awk awk = new Awk();

Construct it with AwkSettings when you need engine defaults such as field separators, locale, or record separators:

AwkSettings settings = new AwkSettings();
settings.setFieldSeparator(",");

Awk awk = new Awk(settings);

AwkSettings settings = new AwkSettings();
settings.setPosix(true);

Awk awk = new Awk(settings);

Awk awk = new Awk(new GawkExtension(), new MyExtension());

The Shortest Path: script().execute()

script().execute() is the smallest API surface for full AWK programs when you want the printed output back as a Java String:

Awk awk = new Awk();
String result = awk.script("{ print toupper($0) }").input("hello world").execute();
// result = "HELLO WORLD\n"

Use this when:

• you already have the script and input in memory
• you want the rendered AWK output as a String
• you do not need explicit ARGV, per-execution variables, or runtime reuse

Compiled Programs

When the same script will be reused, compile it once and run the compiled program:

Awk awk = new Awk();
AwkProgram program = awk.compile("{ print prefix $1 }");

awk.script(program)
        .input("alpha beta\n")
        .execute();

Output Destination

Where the script's output goes is decided by the execute(...) overload you call:

• execute() returns the printed output as a String
• execute(PrintStream) sends output to a PrintStream such as System.out
• execute(OutputStream) sends output to any OutputStream
• execute(Appendable) captures text into a StringBuilder or Appendable
• execute(AwkSink) hands raw print/printf calls to your own AwkSink^[8], so the host can collect structured values instead of rendered text

See the Custom Output^[3] guide for the full AwkSink contract, the built-in implementations, and locale handling.

Reusable Runtime: AVM

When you want to keep the same runtime alive across several calls, create an AVM:

Awk awk = new Awk();
AwkProgram program = awk.compile("BEGIN { print \"value\" }");

try (AVM avm = awk.createAvm()) {
    avm.setAwkSink(mySink);
    avm.execute(program, myInputSource, Collections.<String>emptyList(), null);
    avm.execute(program, myOtherInputSource);
}

AVM is sequential-only and intentionally stateful. Use it when performance matters and you want one reusable runtime for repeated program runs or repeated expression evaluation.

Which API Should I Use?

• script(text).input(text).execute() for the shortest string-in, string-out path.
• compile(...) plus script(compiled).execute(out) when a whole AWK program is reused.
• compileExpression(...) plus eval(...) when one expression is reused.
• createAvm() when you want one reusable runtime across several calls.

Complete Example

The example below reads CSV input, sums the second column per category in the first column, and captures the result:

import io.jawk.Awk;
import io.jawk.util.AwkSettings;

public class JawkDemo {
    public static void main(String[] args) throws Exception {
        // Configure the engine for CSV input
        AwkSettings settings = new AwkSettings();
        settings.setFieldSeparator(",");

        Awk awk = new Awk(settings);

        // AWK script: accumulate totals by category, print sorted results
        String script = "{ totals[$1] += $2 } END { for (k in totals) print k, totals[k] }";

        // Input data
        String csv = "fruit,10\nvegetable,20\nfruit,15\nvegetable,5\n";

        // Execute and capture the printed output
        String result = awk.script(script).input(csv).execute();
        System.out.println(result);
    }
}

See Also

• Variables and Arguments^[4]
• Structured Input^[9]
• Custom Output^[3]
• Compile, Eval, and Reuse^[10]
• Advanced Runtime^[11] — AVM reuse, sandboxing, JSR 223, and thread safety
• Using Extensions^[12]