gnu.lists

Class FString

java.lang.Object

gnu.lists.AbstractSequence<E>

gnu.lists.IndirectIndexable<E>

gnu.lists.SimpleVector<E>

gnu.lists.AbstractCharVector<Char>

gnu.lists.FString

All Implemented Interfaces:

BoundedHashable, Array<Char>, CharSeq, Consumable, Sequence<Char>, java.io.Externalizable, java.io.Serializable, java.lang.Appendable, java.lang.CharSequence, java.lang.Comparable, java.lang.Iterable<Char>, java.util.Collection<Char>, java.util.List<Char>, java.util.RandomAccess

Direct Known Subclasses:

CharBuffer, SwtCharBuffer

public class FString
extends AbstractCharVector<Char>
implements java.lang.Appendable, CharSeq, Consumable

Simple adjustable-length vector whose elements are 32-bit code points Used for the Scheme string type.

See Also:

Serialized Form

Field Summary

Fields inherited from class gnu.lists.AbstractCharVector

data, empty

Fields inherited from class gnu.lists.IndirectIndexable

cantWriteMarker, indexes

Fields inherited from interface gnu.lists.Sequence

ATTRIBUTE_VALUE, BOOLEAN_VALUE, CDATA_VALUE, CHAR_VALUE, COMMENT_VALUE, DOCUMENT_VALUE, DOUBLE_VALUE, ELEMENT_VALUE, EOF_VALUE, eofValue, FLOAT_VALUE, INT_S16_VALUE, INT_S32_VALUE, INT_S64_VALUE, INT_S8_VALUE, INT_U16_VALUE, INT_U32_VALUE, INT_U64_VALUE, INT_U8_VALUE, OBJECT_VALUE, PRIM_VALUE, PROCESSING_INSTRUCTION_VALUE, TEXT_BYTE_VALUE

Constructor Summary

Constructors

Constructor and Description
FString()
FString(char[] values) Create an FString from a char[].
FString(char[] buffer, int offset, int length) This constructor makes a copy.
FString(char[] data, IntSequence indexes)
FString(java.lang.CharSequence seq)
FString(java.lang.CharSequence seq, int offset, int length)
FString(int num)
FString(int num, int value)
FString(Sequence seq)
FString(java.lang.String str)
FString(java.lang.StringBuffer buffer)
FString(java.lang.StringBuffer buffer, int offset, int length)
FString(java.lang.StringBuilder buffer)
FString(java.lang.StringBuilder buffer, int offset, int length)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	addAll(java.lang.CharSequence s)
void	addAllStrings(java.lang.Object[] args, int startIndex) Append arguments to this FString.
static FString	alloc(int sz) Create a empty string, but with a given initial buffer size.
FString	append(char c)
FString	append(java.lang.CharSequence csq)
FString	append(java.lang.CharSequence csq, int start, int end)
FString	append(java.lang.Object obj)
FString	appendCharacter(int c) Append a Unicode code point.
int	characterAt(int index)
void	consume(Consumer out)
void	consumePosRange(int iposStart, int iposEnd, Consumer out)
FString	copy(int start, int end)
boolean	equals(java.lang.Object obj) Must override, since we override hashCode.
void	fill(char ch) Set all the elements to a given character.
void	fill(int fromIndex, int toIndex, char value)
Char	get(int index) See java.util.List.
Char	getBuffer(int index)
int	getElementKind()
java.lang.String	getTag() This is convenience hack for printing "uniform vectors" (srfi 4).
int	indexOf(int ch, int fromChar)
void	insert(int where, int ch, boolean beforeMarkers)
void	insert(int where, java.lang.String str, boolean beforeMarkers)
void	insertRepeated(int where, int value, int count)
int	lastIndexOf(int ch, int fromChar)
void	replace(java.lang.CharSequence src, int srcStart, int srcEnd, int dstStart, int dstEnd) Replace a substring of this string with another.
void	replace(int where, char[] chars, int start, int count)
void	replace(int where, java.lang.String string)
Char	set(int index, Char value) See java.util.List.
void	setAt(int index, Char value) A set without a get - may avoid useless boxing.
void	setBuffer(int index, Char value)
void	setCharacterAt(int index, int ch)
void	setCharAt(int index, char ch)
void	setCharAtBuffer(int index, char ch)
void	shift(int srcStart, int dstStart, int count)
CharSeq	subSequence(int start, int end)
java.lang.String	substring(int start, int end)
char[]	toCharArray() Return a char[] contain the characters of this string.
java.lang.String	toString()
protected FString	withIndexes(IntSequence ind) Create a new instance with the same data and replaces indexes.
void	writeTo(java.lang.Appendable dest)
void	writeTo(int start, int count, java.lang.Appendable dest) Append a specified subsequence to an Appendable.

Methods inherited from class gnu.lists.AbstractCharVector

charAt, charAtBuffer, clearBuffer, compareTo, compareTo, compareTo, ensureBufferLength, equals, getBuffer, getBufferLength, getChars, hashCode, length, openReader, openReader, setBuffer, setBufferLength

Methods inherited from class gnu.lists.SimpleVector

add, add, addPos, addSpace, delete, fill, getGapManager, getRowMajor, getSegment, getSegment, getSegmentReadOnly, getStableManager, isAfterPos, readExternal, toDataArray, transpose, writeExternal

Methods inherited from class gnu.lists.IndirectIndexable

checkCanWrite, getIndexesForce, indexesSelect, indexesSubList, nextPos, select, size, subList

Methods inherited from class gnu.lists.AbstractSequence

addAll, addAll, boundedHash, clear, compare, compare, compare, consume, consumeNext, contains, containsAll, copyPos, createPos, createRelativePos, elements, endPos, equals, fill, fillPosRange, firstAttributePos, firstChildPos, firstChildPos, fromEndIndex, get, getAttribute, getAttributeLength, getContainingSequenceSize, getEffectiveIndex, getIndexDifference, getIterator, getIterator, getIteratorAtPos, getLowBound, getNextKind, getNextTypeName, getNextTypeObject, getPosNext, getPosPrevious, getSize, gotoAttributesStart, gotoChildrenStart, gotoParent, hasNext, hasPrevious, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, nextIndex, nextIndex, nextMatching, parentPos, previousPos, rank, releasePos, remove, remove, removeAll, removePos, removePosRange, retainAll, set, setPosNext, setPosPrevious, stableCompare, startPos, subSequence, subSequencePos, toArray, toArray, toString, unsupported, unsupportedException

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface gnu.lists.CharSeq

charAt, consume, getChars, length

Methods inherited from interface gnu.lists.Sequence

elements, fill, isEmpty, size

Methods inherited from interface java.util.List

add, add, addAll, addAll, clear, contains, containsAll, hashCode, indexOf, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, retainAll, subList, toArray, toArray

Methods inherited from interface gnu.kawa.util.BoundedHashable

boundedHash

Methods inherited from interface gnu.lists.Array

get, getEffectiveIndex, getLowBound, getSize, isEmpty, rank, set

Constructor Detail

FString

public FString()

FString

public FString(int num)

FString

public FString(int num,
       int value)

FString

public FString(char[] values)

Create an FString from a char[]. Note that this contructor does *not* copy the argument.

FString

public FString(char[] data,
       IntSequence indexes)

FString

public FString(java.lang.String str)

FString

public FString(java.lang.StringBuilder buffer)

FString

public FString(java.lang.StringBuilder buffer,
       int offset,
       int length)

FString

public FString(java.lang.StringBuffer buffer)

FString

public FString(java.lang.StringBuffer buffer,
       int offset,
       int length)

FString

public FString(char[] buffer,
       int offset,
       int length)

This constructor makes a copy.

FString

public FString(Sequence seq)

FString

public FString(java.lang.CharSequence seq)

FString

public FString(java.lang.CharSequence seq,
       int offset,
       int length)

Method Detail

alloc

public static FString alloc(int sz)

Create a empty string, but with a given initial buffer size.

getBuffer

public final Char getBuffer(int index)

Specified by:

getBuffer in class SimpleVector<Char>

get

public final Char get(int index)

Description copied from class: AbstractSequence

See java.util.List.

Specified by:

get in interface Sequence<Char>

Specified by:

get in interface java.util.List<Char>

Overrides:

get in class SimpleVector<Char>

indexOf

public int indexOf(int ch,
          int fromChar)

lastIndexOf

public int lastIndexOf(int ch,
              int fromChar)

set

public Char set(int index,
       Char value)

Description copied from interface: Sequence

See java.util.List.

Specified by:

set in interface Sequence<Char>

Specified by:

set in interface java.util.List<Char>

Overrides:

set in class SimpleVector<Char>

setAt

public void setAt(int index,
         Char value)

Description copied from interface: Sequence

A set without a get - may avoid useless boxing.

Specified by:

setAt in interface Sequence<Char>

Overrides:

setAt in class SimpleVector<Char>

setBuffer

public final void setBuffer(int index,
             Char value)

Specified by:

setBuffer in class SimpleVector<Char>

characterAt

public final int characterAt(int index)

toCharArray

public char[] toCharArray()

Return a char[] contain the characters of this string. It is unspecified if the result is a copy or shares with this FString.

shift

public void shift(int srcStart,
         int dstStart,
         int count)

Overrides:

shift in class SimpleVector<Char>

copy

public FString copy(int start,
           int end)

addAll

public boolean addAll(java.lang.CharSequence s)

insert

public void insert(int where,
          int ch,
          boolean beforeMarkers)

insert

public void insert(int where,
          java.lang.String str,
          boolean beforeMarkers)

addAllStrings

public void addAllStrings(java.lang.Object[] args,
                 int startIndex)

Append arguments to this FString. Used to implement Scheme's string-append.

Parameters:

args - an array of FString value

startIndex - index of first string in args to use

toString

public java.lang.String toString()

Specified by:

toString in interface CharSeq

Specified by:

toString in interface java.lang.CharSequence

Overrides:

toString in class AbstractSequence<Char>

substring

public java.lang.String substring(int start,
                         int end)

subSequence

public CharSeq subSequence(int start,
                  int end)

Specified by:

subSequence in interface CharSeq

Specified by:

subSequence in interface java.lang.CharSequence

setCharAt

public void setCharAt(int index,
             char ch)

Specified by:

setCharAt in interface CharSeq

setCharacterAt

public void setCharacterAt(int index,
                  int ch)

Specified by:

setCharacterAt in interface CharSeq

replace

public void replace(java.lang.CharSequence src,
           int srcStart,
           int srcEnd,
           int dstStart,
           int dstEnd)

Replace a substring of this string with another. The two strings may have different lengths, so this generalizes insertion and deletion.

setCharAtBuffer

public void setCharAtBuffer(int index,
                   char ch)

fill

public final void fill(char ch)

Set all the elements to a given character.

Specified by:

fill in interface CharSeq

fill

public void fill(int fromIndex,
        int toIndex,
        char value)

Specified by:

fill in interface CharSeq

insertRepeated

public void insertRepeated(int where,
                  int value,
                  int count)

replace

public void replace(int where,
           char[] chars,
           int start,
           int count)

replace

public void replace(int where,
           java.lang.String string)

equals

public boolean equals(java.lang.Object obj)

Description copied from class: AbstractCharVector

Must override, since we override hashCode.

Specified by:

equals in interface java.util.Collection<Char>

Specified by:

equals in interface java.util.List<Char>

Specified by:

equals in class AbstractCharVector<Char>

withIndexes

protected FString withIndexes(IntSequence ind)

Description copied from class: IndirectIndexable

Create a new instance with the same data and replaces indexes.

Specified by:

withIndexes in class IndirectIndexable<Char>

getElementKind

public int getElementKind()

getTag

public java.lang.String getTag()

Description copied from class: SimpleVector

This is convenience hack for printing "uniform vectors" (srfi 4). It may go away without notice!

Overrides:

getTag in class SimpleVector<Char>

consume

public void consume(Consumer out)

Specified by:

consume in interface Consumable

Overrides:

consume in class AbstractSequence<Char>

consumePosRange

public void consumePosRange(int iposStart,
                   int iposEnd,
                   Consumer out)

Overrides:

consumePosRange in class AbstractSequence<Char>

append

public FString append(char c)

Specified by:

append in interface java.lang.Appendable

appendCharacter

public FString appendCharacter(int c)

Append a Unicode code point.

append

public FString append(java.lang.CharSequence csq)

Specified by:

append in interface java.lang.Appendable

append

public FString append(java.lang.CharSequence csq,
             int start,
             int end)

Specified by:

append in interface java.lang.Appendable

append

public FString append(java.lang.Object obj)

writeTo

public void writeTo(int start,
           int count,
           java.lang.Appendable dest)
             throws java.io.IOException

Description copied from interface: CharSeq

Append a specified subsequence to an Appendable. An allowable implementation is: dest.append(this, start, start+count). Hence implementors of Appendable should avoid calling writeTo - though they can call getChars.

Specified by:

writeTo in interface CharSeq

Throws:

java.io.IOException

writeTo

public void writeTo(java.lang.Appendable dest)
             throws java.io.IOException

Specified by:

writeTo in interface CharSeq

Throws:

java.io.IOException