public interface

ICLabelFactory

com.pnfsoftware.jeb.core.units.code.asm.decompiler.ast.ICLabelFactory

Class Overview

A manager of ICLabel. Each ICMethod has its own label factory.

Summary

Public Methods
abstract ICLabel create(long offset, String name)
Create a named label.
abstract ICLabel create(long offset)
Create a named label.
abstract ICLabel create()
Create a label.
abstract ICLabel get(long offset)
Retrieve an existing label by offset.
abstract ICLabel get(String name)
Retrieve an existing label by name.
abstract Collection<ICLabel> getLabels()
Retrieve a read-only collection of labels defined by the factory.

Public Methods

public abstract ICLabel create (long offset, String name)

Create a named label.

Parameters
offset a client-defined offset, that may or may not represent a valid location within the instruction sequence used to build this AST. In practice, this offset should be an IR instruction one.
name mandatory label name, should be unique, or the method will throw an exception.
Returns
  • the newly created label

public abstract ICLabel create (long offset)

Create a named label. The label will be auto-generated from the provided address.

Parameters
offset a client-defined offset, that may or may not represent a valid location within the instruction sequence used to build this AST. In practice, this offset should be an IR instruction one.

public abstract ICLabel create ()

Create a label.

public abstract ICLabel get (long offset)

Retrieve an existing label by offset.

Parameters
offset label offset
Returns
  • the label or null

public abstract ICLabel get (String name)

Retrieve an existing label by name.

Parameters
name label name
Returns
  • the label or null

public abstract Collection<ICLabel> getLabels ()

Retrieve a read-only collection of labels defined by the factory.