Progeneric.Ptl.Allocators

Class StackAlloc64<TSequence extends IContainer64<java.lang.Long> & IBackSequence<java.lang.Long>>

java.lang.Object

Progeneric.Ptl.Allocators.StackAlloc64<TSequence>

Type Parameters:

TSequence - The type of the specified sequence.

All Implemented Interfaces:

IAllocator64

Direct Known Subclasses:

StackAlloc64_

public class StackAlloc64<TSequence extends IContainer64<java.lang.Long> & IBackSequence<java.lang.Long>>
extends java.lang.Object
implements IAllocator64

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
StackAlloc64(TSequence sequence) Creates a new instance of StackAlloc64 with the specified sequence.
StackAlloc64(TSequence sequence, long highestAddress) Creates a new instance of StackAlloc64 with the specified sequence and highest address.

Method Summary

Methods

Modifier and Type	Method and Description
long	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).
long	Count() Returns the number of addresses already allocated.
void	Deallocate(long address) Frees a location (address) that was allocated with Allocate().
long	MaxSize() Returns the allocator's maximum possible size (the highest address).
long	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

StackAlloc64

public StackAlloc64(TSequence sequence)

Creates a new instance of StackAlloc64 with the specified sequence.

Parameters:

sequence - The specified sequence.

StackAlloc64

public StackAlloc64(TSequence sequence,
            long highestAddress)

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

Parameters:

sequence - The specified sequence.

highestAddress - The specified highest address.

Method Detail

Size

public long Size()

Returns the number of addresses (highest address).

Returns:

The number of addresses (highest address).

MaxSize

public long MaxSize()

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

Returns:

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

Count

public long 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 long Allocate()

Returns the next available location (address).

Specified by:

Allocate in interface IAllocator64

Returns:

The next available location (address).

Deallocate

public void Deallocate(long 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 IAllocator64

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).