soot.util

Class EmptyChain

java.lang.Object

soot.util.EmptyChain

All Implemented Interfaces:

java.io.Serializable, java.lang.Iterable, java.util.Collection, Chain

public class EmptyChain
extends java.lang.Object
implements Chain

Class representing an unmodifiable empty chain

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
EmptyChain()

Method Summary

Modifier and Type	Method and Description
boolean	add(java.lang.Object e)
boolean	addAll(java.util.Collection c)
void	addFirst(java.lang.Object u) Adds the given object at the beginning of the Chain.
void	addLast(java.lang.Object u) Adds the given object at the end of the Chain.
void	clear()
boolean	contains(java.lang.Object o)
boolean	containsAll(java.util.Collection c)
boolean	follows(java.lang.Object someObject, java.lang.Object someReferenceObject) Returns true if object someObject follows object someReferenceObject in the Chain.
java.util.Collection	getElementsUnsorted() Gets all elements in the chain.
java.lang.Object	getFirst() Returns the first object in this Chain.
java.lang.Object	getLast() Returns the last object in this Chain.
long	getModificationCount() Returns the number of times this chain has been modified.
java.lang.Object	getPredOf(java.lang.Object point) Returns the object immediately preceding point.
java.lang.Object	getSuccOf(java.lang.Object point) Returns the object immediately following point.
void	insertAfter(Chain toInsert, java.lang.Object point) Inserts toInsert in the Chain after point.
void	insertAfter(java.util.List toInsert, java.lang.Object point) Inserts toInsert in the Chain after point.
void	insertAfter(java.lang.Object toInsert, java.lang.Object point) Inserts toInsert in the Chain after point.
void	insertBefore(Chain toInsert, java.lang.Object point) Inserts toInsert in the Chain before point.
void	insertBefore(java.util.List toInsert, java.lang.Object point) Inserts toInsert in the Chain before point.
void	insertBefore(java.lang.Object toInsert, java.lang.Object point) Inserts toInsert in the Chain before point.
void	insertOnEdge(Chain toInsert, java.lang.Object point_src, java.lang.Object point_tgt) Inserts instrumentation in a manner such that the resulting control flow graph (CFG) of the program will contain toInsert on an edge that is defined by point_source and point_target.
void	insertOnEdge(java.util.List toInsert, java.lang.Object point_src, java.lang.Object point_tgt) Inserts instrumentation in a manner such that the resulting control flow graph (CFG) of the program will contain toInsert on an edge that is defined by point_source and point_target.
void	insertOnEdge(java.lang.Object toInsert, java.lang.Object point_src, java.lang.Object point_tgt) Inserts instrumentation in a manner such that the resulting control flow graph (CFG) of the program will contain toInsert on an edge that is defined by point_source and point_target.
boolean	isEmpty()
java.util.Iterator	iterator() Returns an iterator over this Chain.
java.util.Iterator	iterator(java.lang.Object u) Returns an iterator over this Chain, starting at the given object.
java.util.Iterator	iterator(java.lang.Object head, java.lang.Object tail) Returns an iterator over this Chain, starting at head and reaching tail (inclusive).
boolean	remove(java.lang.Object u) Removes the given object from this Chain.
boolean	removeAll(java.util.Collection c)
void	removeFirst() Removes the first object contained in this Chain.
void	removeLast() Removes the last object contained in this Chain.
boolean	retainAll(java.util.Collection c)
int	size() Returns the size of this Chain.
java.util.Iterator	snapshotIterator() Returns an iterator over a copy of this chain.
void	swapWith(java.lang.Object out, java.lang.Object in) Replaces out in the Chain by in.
java.lang.Object[]	toArray()
java.lang.Object[]	toArray(java.lang.Object[] a)
static EmptyChain	v()

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Collection

equals, hashCode, parallelStream, removeIf, spliterator, stream

Methods inherited from interface java.lang.Iterable

forEach

Constructor Detail

EmptyChain

public EmptyChain()

Method Detail

v

public static EmptyChain v()

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface java.util.Collection

contains

public boolean contains(java.lang.Object o)

Specified by:

contains in interface java.util.Collection

toArray

public java.lang.Object[] toArray()

Specified by:

toArray in interface java.util.Collection

toArray

public java.lang.Object[] toArray(java.lang.Object[] a)

Specified by:

toArray in interface java.util.Collection

add

public boolean add(java.lang.Object e)

Specified by:

add in interface java.util.Collection

containsAll

public boolean containsAll(java.util.Collection c)

Specified by:

containsAll in interface java.util.Collection

addAll

public boolean addAll(java.util.Collection c)

Specified by:

addAll in interface java.util.Collection

removeAll

public boolean removeAll(java.util.Collection c)

Specified by:

removeAll in interface java.util.Collection

retainAll

public boolean retainAll(java.util.Collection c)

Specified by:

retainAll in interface java.util.Collection

clear

public void clear()

Specified by:

clear in interface java.util.Collection

insertBefore

public void insertBefore(java.util.List toInsert,
                         java.lang.Object point)

Description copied from interface: Chain

Inserts toInsert in the Chain before point.

Specified by:

insertBefore in interface Chain

insertAfter

public void insertAfter(java.util.List toInsert,
                        java.lang.Object point)

Description copied from interface: Chain

Inserts toInsert in the Chain after point.

Specified by:

insertAfter in interface Chain

insertAfter

public void insertAfter(java.lang.Object toInsert,
                        java.lang.Object point)

Description copied from interface: Chain

Inserts toInsert in the Chain after point.

Specified by:

insertAfter in interface Chain

insertBefore

public void insertBefore(java.lang.Object toInsert,
                         java.lang.Object point)

Description copied from interface: Chain

Inserts toInsert in the Chain before point.

Specified by:

insertBefore in interface Chain

insertBefore

public void insertBefore(Chain toInsert,
                         java.lang.Object point)

Description copied from interface: Chain

Inserts toInsert in the Chain before point. (It would probably be better to make Chain implement List)

Specified by:

insertBefore in interface Chain

insertAfter

public void insertAfter(Chain toInsert,
                        java.lang.Object point)

Description copied from interface: Chain

Inserts toInsert in the Chain after point. (It would probably be better to make Chain implement List)

Specified by:

insertAfter in interface Chain

insertOnEdge

public void insertOnEdge(java.lang.Object toInsert,
                         java.lang.Object point_src,
                         java.lang.Object point_tgt)

Description copied from interface: Chain

Inserts instrumentation in a manner such that the resulting control flow graph (CFG) of the program will contain toInsert on an edge that is defined by point_source and point_target.

Specified by:

insertOnEdge in interface Chain

Parameters:

toInsert - the instrumentation to be added in the Chain

point_src - the source point of an edge in CFG

point_tgt - the target point of an edge

insertOnEdge

public void insertOnEdge(java.util.List toInsert,
                         java.lang.Object point_src,
                         java.lang.Object point_tgt)

Description copied from interface: Chain

Inserts instrumentation in a manner such that the resulting control flow graph (CFG) of the program will contain toInsert on an edge that is defined by point_source and point_target.

Specified by:

insertOnEdge in interface Chain

Parameters:

toInsert - instrumentation to be added in the Chain

point_src - the source point of an edge in CFG

point_tgt - the target point of an edge

insertOnEdge

public void insertOnEdge(Chain toInsert,
                         java.lang.Object point_src,
                         java.lang.Object point_tgt)

Description copied from interface: Chain

Inserts instrumentation in a manner such that the resulting control flow graph (CFG) of the program will contain toInsert on an edge that is defined by point_source and point_target.

Specified by:

insertOnEdge in interface Chain

Parameters:

toInsert - instrumentation to be added in the Chain

point_src - the source point of an edge in CFG

point_tgt - the target point of an edge

swapWith

public void swapWith(java.lang.Object out,
                     java.lang.Object in)

Description copied from interface: Chain

Replaces out in the Chain by in.

Specified by:

swapWith in interface Chain

remove

public boolean remove(java.lang.Object u)

Description copied from interface: Chain

Removes the given object from this Chain. Parameter has to be of type Object to be compatible with the Collection interface.

Specified by:

remove in interface java.util.Collection

Specified by:

remove in interface Chain

addFirst

public void addFirst(java.lang.Object u)

Description copied from interface: Chain

Adds the given object at the beginning of the Chain.

Specified by:

addFirst in interface Chain

addLast

public void addLast(java.lang.Object u)

Description copied from interface: Chain

Adds the given object at the end of the Chain.

Specified by:

addLast in interface Chain

removeFirst

public void removeFirst()

Description copied from interface: Chain

Removes the first object contained in this Chain.

Specified by:

removeFirst in interface Chain

removeLast

public void removeLast()

Description copied from interface: Chain

Removes the last object contained in this Chain.

Specified by:

removeLast in interface Chain

follows

public boolean follows(java.lang.Object someObject,
                       java.lang.Object someReferenceObject)

Description copied from interface: Chain

Returns true if object someObject follows object someReferenceObject in the Chain.

Specified by:

follows in interface Chain

getFirst

public java.lang.Object getFirst()

Description copied from interface: Chain

Returns the first object in this Chain.

Specified by:

getFirst in interface Chain

getLast

public java.lang.Object getLast()

Description copied from interface: Chain

Returns the last object in this Chain.

Specified by:

getLast in interface Chain

getSuccOf

public java.lang.Object getSuccOf(java.lang.Object point)

Description copied from interface: Chain

Returns the object immediately following point.

Specified by:

getSuccOf in interface Chain

getPredOf

public java.lang.Object getPredOf(java.lang.Object point)

Description copied from interface: Chain

Returns the object immediately preceding point.

Specified by:

getPredOf in interface Chain

snapshotIterator

public java.util.Iterator snapshotIterator()

Description copied from interface: Chain

Returns an iterator over a copy of this chain. This avoids ConcurrentModificationExceptions from being thrown if the underlying Chain is modified during iteration. Do not use this to remove elements which have not yet been iterated over!

Specified by:

snapshotIterator in interface Chain

iterator

public java.util.Iterator iterator()

Description copied from interface: Chain

Returns an iterator over this Chain.

Specified by:

iterator in interface java.lang.Iterable

Specified by:

iterator in interface java.util.Collection

Specified by:

iterator in interface Chain

iterator

public java.util.Iterator iterator(java.lang.Object u)

Description copied from interface: Chain

Returns an iterator over this Chain, starting at the given object.

Specified by:

iterator in interface Chain

iterator

public java.util.Iterator iterator(java.lang.Object head,
                                   java.lang.Object tail)

Description copied from interface: Chain

Returns an iterator over this Chain, starting at head and reaching tail (inclusive).

Specified by:

iterator in interface Chain

size

public int size()

Description copied from interface: Chain

Returns the size of this Chain.

Specified by:

size in interface java.util.Collection

Specified by:

size in interface Chain

getModificationCount

public long getModificationCount()

Description copied from interface: Chain

Returns the number of times this chain has been modified.

Specified by:

getModificationCount in interface Chain

getElementsUnsorted

public java.util.Collection getElementsUnsorted()

Description copied from interface: Chain

Gets all elements in the chain. There is no guarantee on sorting. On the other hand, the collection returned by this method is thread-safe. You can iterate over it even in the case of concurrent modifications to the underlying chain.

Specified by:

getElementsUnsorted in interface Chain

Returns:

All elements in the chain in an unsorted collection