Package org.sentrysoftware.jawk

Class Awk

java.lang.Object

org.sentrysoftware.jawk.Awk

public class Awk
extends Object

Entry point into the parsing, analysis, and execution of a Jawk script. This entry point is used when Jawk is executed as a library. If you want to use Jawk as a stand-alone application, please use .

The overall process to execute a Jawk script is as follows:

• Parse the Jawk script, producing an abstract syntax tree.
• Traverse the abstract syntax tree, producing a list of instruction tuples for the interpreter.
• Traverse the list of tuples, providing a runtime which ultimately executes the Jawk script, or Command-line parameters dictate which action is to take place.

Two additional semantic checks on the syntax tree are employed (both to resolve function calls for defined functions). As a result, the syntax tree is traversed three times. And the number of times tuples are traversed is depends on whether interpretation or compilation takes place.

By default a minimal set of extensions are automatically included. Please refer to the EXTENSION_PREFIX static field contents for an up-to-date list. As of the initial release of the extension system, the prefix defines the following extensions:

• CoreExtension
• SocketExtension
• StdinExtension

Author:

Danny Daglas

See Also:

• AVM

Constructor Summary

Constructors

Constructor	Description
Awk()	Create a new instance of Awk

Method Summary

Modifier and Type	Method	Description
void	invoke(AwkSettings settings)	invoke.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

Awk

public Awk()

Create a new instance of Awk

Method Details

invoke

public void invoke(AwkSettings settings)
            throws IOException,
ClassNotFoundException,
ExitException

invoke.

Parameters:

settings - This tells AWK what to do (where to get input from, where to write it to, in what mode to run, ...)

Throws:

IOException - upon an IO error.

ClassNotFoundException - if intermediate code is specified but deserialization fails to load in the JVM

ExitException - if interpretation is requested, and a specific exit code is requested.