Modifier and Type	Class and Description
public abstract static class	AbstractIntArrayBuilder.Forward Abstract base of integer array builders that append to their content, building the result left to right.
public abstract static class	AbstractIntArrayBuilder.Reverse Abstract base of integer array builders that prepend to their content, building the result right to left.

Modifier and Type	Field and Description
protected static final int[]	EMPTY_INT_ARRAY An empty array of int for builder initial state, etc..
protected static final int	MINSIZE Number of elements by default.

Access	Constructor and Description
public	AbstractIntArrayBuilder()

Method Summary

Modifier and Type	Method and Description
protected abstract void	ensure(int to make additional space for n) Ensure there is room for another `n` elements.
public abstract int	Returns: the number of elements currently. length() The number of elements currently
public abstract int	Returns: The maximum int stored. max() The maximum value stored.
public abstract Object	Returns: the contents as a Python `str` take() Provide the contents as an array and reset the builder to empty.
public String	toString() Overrides java.lang.Object.toString. Provide the contents as a Java `String` (non-destructively, but inefficiently).
protected abstract int[]	Returns: the elements in the buffer value() An array of the elements in the buffer (not modified by methods on this object hereafter).

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll wait wait wait

EMPTY_INT_ARRAY	back to summary
protected static final int[] EMPTY_INT_ARRAY An empty array of int for builder initial state, etc..

MINSIZE	back to summary
protected static final int MINSIZE Number of elements by default.

Constructor Detail

AbstractIntArrayBuilder	back to summary
public AbstractIntArrayBuilder()

Method Detail

ensure back to summary

ensure	back to summary
protected abstract void ensure(int n) Ensure there is room for another `n` elements. In general, this will mean allocating new storage (of a carefully-chosen size ≥ `n+length()`) and copying the existing contents to it. Parameters n:int to make additional space for

protected abstract void ensure(int n)

Ensure there is room for another n elements. In general, this will mean allocating new storage (of a carefully-chosen size ≥ n+length()) and copying the existing contents to it.

Parameters

n:int: to make additional space for

length	back to summary
public abstract int length() The number of elements currently Returns:int the number of elements currently.

length

back to summary

public abstract int length()

The number of elements currently

Returns:int: the number of elements currently.

max	back to summary
public abstract int max() The maximum value stored. Implementation Note The motivation for this is to know the range of code point values when representing a string. An over-estimate would be ok.) Returns:int The maximum int stored.

max

back to summary

public abstract int max()

The maximum value stored.

Implementation Note

The motivation for this is to know the range of code point values when representing a string. An over-estimate would be ok.)

Returns:int: The maximum int stored.

take back to summary

take	back to summary
public abstract Object take() Provide the contents as an array and reset the builder to empty. (This is a "destructive read".) The return type is Object in order that sub-classes may define the specific type (for example, `int[]` or `byte[]`). Implementation Note In many implementations, if the client has chosen an initial capacity exactly matching `length()` at the time this method is called, then the result may be returned without a copy. (This must be the last remaining reference to the array originally allocated: it must be impossible for the the builder to re-use it.) Otherwise, returning a new array is inevitable. Returns:Object the contents as a Python `str`

public abstract Object take()

Provide the contents as an array and reset the builder to empty. (This is a "destructive read".) The return type is Object in order that sub-classes may define the specific type (for example, int[] or byte[]).

Implementation Note

In many implementations, if the client has chosen an initial capacity exactly matching length() at the time this method is called, then the result may be returned without a copy. (This must be the last remaining reference to the array originally allocated: it must be impossible for the the builder to re-use it.) Otherwise, returning a new array is inevitable.

Returns:Object: the contents as a Python str

toString back to summary

toString	back to summary
public String toString() Overrides java.lang.Object.toString. Provide the contents as a Java `String` (non-destructively, but inefficiently). Returns:String Doc from java.lang.Object.toString. a string representation of the object. Annotations @Override

public String toString()

Overrides java.lang.Object.toString.

Provide the contents as a Java String (non-destructively, but inefficiently).

Returns:String

Doc from java.lang.Object.toString.

a string representation of the object.

Annotations

@Override

value	back to summary
protected abstract int[] value() An array of the elements in the buffer (not modified by methods on this object hereafter). Returns:int[] the elements in the buffer

value

back to summary

protected abstract int[] value()

An array of the elements in the buffer (not modified by methods on this object hereafter).

Returns:int[]: the elements in the buffer

org.python.core.stringlib back to summary

public abstract Class AbstractIntArrayBuilder.Forward

Class Inheritance

extends AbstractIntArrayBuilder

java.lang.Object
org.python.core.stringlib.AbstractIntArrayBuilder
org.python.core.stringlib.AbstractIntArrayBuilder.Forward

Known Direct Subclasses

org.python.core.stringlib.ByteArrayBuilder, org.python.core.stringlib.IntArrayBuilder

Abstract base of integer array builders that append to their content, building the result left to right. Implementations need only define appendUnchecked(int).

Field Summary

Inherited from org.python.core.stringlib.AbstractIntArrayBuilder:: EMPTY_INT_ARRAY MINSIZE

Constructor Summary

Access	Constructor and Description
public	Forward()

Method Summary

Modifier and Type	Method and Description
public AbstractIntArrayBuilder.Forward	Returns: this builder append(int to append v) Append one element.
public AbstractIntArrayBuilder.Forward	Returns: this builder append(PySequence.OfInt from which to take items seq) Append all the elements from a sequence.
public AbstractIntArrayBuilder.Forward	Returns: this builder append(Iterator<Integer> from which to take items iter) Append all the elements available from an iterator.
protected abstract void	appendUnchecked(int to append v) Append one element without ensuring that there is space.

Inherited from org.python.core.stringlib.AbstractIntArrayBuilder:: ensure length max take toString value

Constructor Detail

Forward	back to summary
public Forward()

Method Detail

append	back to summary
public AbstractIntArrayBuilder.Forward append(int v) Append one element. Parameters v:int to append Returns:AbstractIntArrayBuilder.Forward this builder

append

back to summary

public AbstractIntArrayBuilder.Forward append(int v)

Append one element.

Parameters

v:int: to append

Returns:AbstractIntArrayBuilder.Forward

this builder

append	back to summary
public AbstractIntArrayBuilder.Forward append(PySequence.OfInt seq) Append all the elements from a sequence. Parameters seq:PySequence.OfInt from which to take items Returns:AbstractIntArrayBuilder.Forward this builder

append

back to summary

public AbstractIntArrayBuilder.Forward append(PySequence.OfInt seq)

Append all the elements from a sequence.

Parameters

seq:PySequence.OfInt: from which to take items

Returns:AbstractIntArrayBuilder.Forward

this builder

append	back to summary
public AbstractIntArrayBuilder.Forward append(Iterator<Integer> iter) Append all the elements available from an iterator. Parameters iter:Iterator<Integer> from which to take items Returns:AbstractIntArrayBuilder.Forward this builder

append

back to summary

public AbstractIntArrayBuilder.Forward append(Iterator<Integer> iter)

Append all the elements available from an iterator.

Parameters

iter:Iterator<Integer>: from which to take items

Returns:AbstractIntArrayBuilder.Forward

this builder

appendUnchecked back to summary

appendUnchecked	back to summary
protected abstract void appendUnchecked(int v) Append one element without ensuring that there is space. This method is for use when it is known that there is space for the element, for example, inside a loop before which when `ensure(int)` has been called. Parameters v:int to append

protected abstract void appendUnchecked(int v)

Append one element without ensuring that there is space. This method is for use when it is known that there is space for the element, for example, inside a loop before which when ensure(int) has been called.

Parameters

v:int: to append

org.python.core.stringlib back to summary

public abstract Class AbstractIntArrayBuilder.Reverse

Class Inheritance

extends AbstractIntArrayBuilder

java.lang.Object
org.python.core.stringlib.AbstractIntArrayBuilder
org.python.core.stringlib.AbstractIntArrayBuilder.Reverse

Known Direct Subclasses

org.python.core.stringlib.IntArrayReverseBuilder

Abstract base of integer array builders that prepend to their content, building the result right to left. Implementations need only define prependUnchecked(int).

Field Summary

Inherited from org.python.core.stringlib.AbstractIntArrayBuilder:: EMPTY_INT_ARRAY MINSIZE

Constructor Summary

Access	Constructor and Description
public	Reverse()

Method Summary

Modifier and Type	Method and Description
public AbstractIntArrayBuilder.Reverse	Returns: this builder prepend(int to prepend v) Prepend one element.
public AbstractIntArrayBuilder.Reverse	Returns: this builder prepend(PySequence.OfInt from which to take items seq) Prepend all the elements from a sequence.
public AbstractIntArrayBuilder.Reverse	Returns: this builder prepend(ListIterator<Integer> from which to take items iter) Prepend all the elements available from an iterator, working backwards with `iter.previous()`.
protected abstract void	prependUnchecked(int to prepend v) Prepend one element without ensuring that there is space.

Inherited from org.python.core.stringlib.AbstractIntArrayBuilder:: ensure length max take toString value

Constructor Detail

Reverse	back to summary
public Reverse()

Method Detail

prepend	back to summary
public AbstractIntArrayBuilder.Reverse prepend(int v) Prepend one element. Parameters v:int to prepend Returns:AbstractIntArrayBuilder.Reverse this builder

prepend

back to summary

public AbstractIntArrayBuilder.Reverse prepend(int v)

Prepend one element.

Parameters

v:int: to prepend

Returns:AbstractIntArrayBuilder.Reverse

this builder

prepend back to summary

prepend	back to summary
public AbstractIntArrayBuilder.Reverse prepend(PySequence.OfInt seq) Prepend all the elements from a sequence. The sequence is not reversed by this: it is prepended the right way around. After the call `seq[0]` is first in the buffer. Parameters seq:PySequence.OfInt from which to take items Returns:AbstractIntArrayBuilder.Reverse this builder

public AbstractIntArrayBuilder.Reverse prepend(PySequence.OfInt seq)

Prepend all the elements from a sequence. The sequence is not reversed by this: it is prepended the right way around. After the call seq[0] is first in the buffer.

Parameters

seq:PySequence.OfInt: from which to take items

Returns:AbstractIntArrayBuilder.Reverse

this builder

prepend back to summary

prepend	back to summary
public AbstractIntArrayBuilder.Reverse prepend(ListIterator<Integer> iter) Prepend all the elements available from an iterator, working backwards with `iter.previous()`. Parameters iter:ListIterator<Integer> from which to take items Returns:AbstractIntArrayBuilder.Reverse this builder

public AbstractIntArrayBuilder.Reverse prepend(ListIterator<Integer> iter)

Prepend all the elements available from an iterator, working backwards with iter.previous().

Parameters

iter:ListIterator<Integer>: from which to take items

Returns:AbstractIntArrayBuilder.Reverse

this builder

prependUnchecked back to summary

prependUnchecked	back to summary
protected abstract void prependUnchecked(int v) Prepend one element without ensuring that there is space. This method is for use when it is known that there is space for the element, for example, inside a loop before which when `ensure(int)` has been called. Parameters v:int to prepend

protected abstract void prependUnchecked(int v)

Prepend one element without ensuring that there is space. This method is for use when it is known that there is space for the element, for example, inside a loop before which when ensure(int) has been called.

Parameters

v:int: to prepend

public abstract Class AbstractIntArrayBuilder

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public abstract Class AbstractIntArrayBuilder.Forward

Field Summary

Constructor Summary

Method Summary

Constructor Detail

Method Detail

public abstract Class AbstractIntArrayBuilder.Reverse

Field Summary

Constructor Summary

Method Summary

Constructor Detail

Method Detail