org.jamplate.impl.instruction

Class CpedAddrXinstr

java.lang.Object

org.jamplate.impl.instruction.CpedAddrXinstr

All Implemented Interfaces:

java.io.Serializable, Instruction

public class CpedAddrXinstr
extends java.lang.Object
implements Instruction

CPED( ADDR , XINSTR )

An instruction that executes a pre-specified array of instructions and capture the printed text and allocate it to a pre-specified address in the heap.

Since:

0.2.0 ~2021.05.28

Version:

0.2.0

Author:

LSafer

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected @NotNull java.lang.String	address The address to allocate the captured text to.
protected @NotNull java.util.List<Instruction>	instructions The instructions to capture its output.
protected @Nullable Tree	tree The tree from where this instruction was declared.

Constructor Summary

Constructors

Constructor and Description
CpedAddrXinstr(@NotNull java.lang.String address, Instruction... instructions) Construct a new instruction that executes the given instructions and capture their output then allocate it to the given address in the heap.
CpedAddrXinstr(@NotNull java.lang.String address, @NotNull java.util.List<Instruction> instructions) Construct a new instruction that executes the given instructions and capture their output then allocate it to the given address in the heap.
CpedAddrXinstr(@NotNull Tree tree, @NotNull java.lang.String address, Instruction... instructions) Construct a new instruction that executes the given instructions and capture their output then allocate it to the given address in the heap.
CpedAddrXinstr(@NotNull Tree tree, @NotNull java.lang.String address, @NotNull java.util.List<Instruction> instructions) Construct a new instruction that executes the given instructions and capture their output then allocate it to the given address in the heap.

Method Summary

Modifier and Type	Method and Description
void	exec(@NotNull Environment environment, @NotNull Memory memory) Execute this instruction with the given environment and memory.
@Nullable Tree	getTree() Return the tree from where this instruction was declared.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.jamplate.model.Instruction

create, create

Field Detail

address

@NotNull
protected final @NotNull java.lang.String address

The address to allocate the captured text to.

Since:

0.2.0 ~2021.06.01

instructions

@NotNull
protected final @NotNull java.util.List<Instruction> instructions

The instructions to capture its output.

Since:

0.2.0 ~2021.06.01

tree

@Nullable
protected final @Nullable Tree tree

The tree from where this instruction was declared.

Since:

0.2.0 ~2021.06.01

Constructor Detail

CpedAddrXinstr

public CpedAddrXinstr(@NotNull
                      @NotNull java.lang.String address,
                      @Nullable
                      Instruction... instructions)

Construct a new instruction that executes the given instructions and capture their output then allocate it to the given address in the heap.
Null instructions in the array will be ignored.

Parameters:

address - the address where to allocate the captured text to.

instructions - the instructions to be executed and their output to be captured.

Throws:

java.lang.NullPointerException - if the given address or instructions is null.

Since:

0.2.0 ~2021.06.01

CpedAddrXinstr

public CpedAddrXinstr(@NotNull
                      @NotNull java.lang.String address,
                      @NotNull
                      @NotNull java.util.List<Instruction> instructions)

Construct a new instruction that executes the given instructions and capture their output then allocate it to the given address in the heap.
Null instructions in the list will be ignored.

Parameters:

address - the address where to allocate the captured text to.

instructions - the instructions to be executed and their output to be captured.

Throws:

java.lang.NullPointerException - if the given address or instructions is null.

Since:

0.2.0 ~2021.06.01

CpedAddrXinstr

public CpedAddrXinstr(@NotNull
                      @NotNull Tree tree,
                      @NotNull
                      @NotNull java.lang.String address,
                      @Nullable
                      Instruction... instructions)

Construct a new instruction that executes the given instructions and capture their output then allocate it to the given address in the heap.
Null instructions in the array will be ignored.

Parameters:

tree - the tree from where this instruction was declared.

address - the address where to allocate the captured text to.

instructions - the instructions to be executed and their output to be captured.

Throws:

java.lang.NullPointerException - if the given tree or address or instructions is null.

Since:

0.2.0 ~2021.06.01

CpedAddrXinstr

public CpedAddrXinstr(@NotNull
                      @NotNull Tree tree,
                      @NotNull
                      @NotNull java.lang.String address,
                      @NotNull
                      @NotNull java.util.List<Instruction> instructions)

Construct a new instruction that executes the given instructions and capture their output then allocate it to the given address in the heap.
Null instructions in the list will be ignored.

Parameters:

tree - the tree from where this instruction was declared.

address - the address where to allocate the captured text to.

instructions - the instructions to be executed and their output to be captured.

Throws:

java.lang.NullPointerException - if the given tree or address or instructions is null.

Since:

0.2.0 ~2021.06.01

Method Detail

exec

public void exec(@NotNull
                 @NotNull Environment environment,
                 @NotNull
                 @NotNull Memory memory)

Description copied from interface: Instruction

Execute this instruction with the given environment and memory.

Specified by:

exec in interface Instruction

Parameters:

environment - the environment this instruction is executed in.

memory - the memory holding the variables for this instruction to depend on.

getTree

@Nullable
public @Nullable Tree getTree()

Description copied from interface: Instruction

Return the tree from where this instruction was declared. (optional)

Specified by:

getTree in interface Instruction

Returns:

the tree of this instruction.