Progeneric.Ptl.Allocators

Class StackAlloc32<TSequence extends IContainer32<java.lang.Integer> & IBackSequence<java.lang.Integer>>

java.lang.Object

Progeneric.Ptl.Allocators.StackAlloc32<TSequence>

Type Parameters:

TSequence - The type of the specified sequence.

All Implemented Interfaces:

IAllocator32

Direct Known Subclasses:

StackAlloc32_

public class StackAlloc32<TSequence extends IContainer32<java.lang.Integer> & IBackSequence<java.lang.Integer>>
extends java.lang.Object
implements IAllocator32

Implements an allocator using a number to store the highest address and a sequence to keep track of released addresses.

The container is allocated in memory and can generate at most TSequence.MaxSize() addresses.

Constructor Summary

Constructors

Constructor and Description
StackAlloc32(TSequence sequence) Creates a new instance of StackAlloc32 with the specified sequence.
StackAlloc32(TSequence sequence, int highestAddress) Creates a new instance of StackAlloc32 with the specified sequence and highest address.

Method Summary

Methods

Modifier and Type	Method and Description
int	Allocate() Returns the next available location (address).
boolean	CanAllocate() Returns true if the allocator's Size is less than its MaxSize.
void	Clear() Frees all locations (addresses).
int	Count() Returns the number of addresses already allocated.
void	Deallocate(int address) Frees a location (address) that was allocated with Allocate().
int	MaxSize() Returns the allocator's maximum possible size (the highest address).
int	Size() Returns the number of addresses (highest address).

Methods inherited from class java.lang.Object

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

Constructor Detail

StackAlloc32

public StackAlloc32(TSequence sequence)

Creates a new instance of StackAlloc32 with the specified sequence.

Parameters:

sequence - The specified sequence.

StackAlloc32

public StackAlloc32(TSequence sequence,
            int highestAddress)

Creates a new instance of StackAlloc32 with the specified sequence and highest address.

Parameters:

sequence - The specified sequence.

highestAddress - The specified highest address.

Method Detail

Size

public int Size()

Returns the number of addresses (highest address).

Returns:

The number of addresses (highest address).

MaxSize

public int MaxSize()

Returns the allocator's maximum possible size (the highest address).

Returns:

The allocator's maximum possible size (the highest address).

Count

public int Count()

Returns the number of addresses already allocated.

Returns:

The number of addresses already allocated.

CanAllocate

public boolean CanAllocate()

Returns true if the allocator's Size is less than its MaxSize.

Returns:

True if the allocator's Size is less than its MaxSize.

Allocate

public int Allocate()

Returns the next available location (address).

Specified by:

Allocate in interface IAllocator32

Returns:

The next available location (address).

Deallocate

public void Deallocate(int address)

Frees a location (address) that was allocated with Allocate().

It is an error to deallocate an address that was already released because it will be pushed into the sequence multiple times.

Specified by:

Deallocate in interface IAllocator32

Parameters:

address - The address to be released.

Throws:

java.lang.RuntimeException - When the specified address is out of the [0, Size - 1] range.

Clear

public void Clear()

Frees all locations (addresses).