org.vishia.util

Class StringPart.Part

java.lang.Object

org.vishia.util.StringPart.Part

All Implemented Interfaces:

java.lang.CharSequence

Enclosing class:

StringPart

public static final class StringPart.Part
extends java.lang.Object
implements java.lang.CharSequence

This class presents a part of the parent CharSequence of this class. The constructor is protected because instances of this class are only created in this class or its derived, not by user. The CharSequence methods get the characters from the parent CharSequence of the environment class StringPart.content.
Important: An instance is only intended for immediate use. Build a String via calling toString() if the text should be persistently stored. Using of the Part instance immediately helps safe calculation time and storage because it does not need allocated memory. It is a cheap operation only with some indices. The content of a Part will become non accessible if the StringPart.content was shifted out especially by invocation of StringPartFromFileLines.readnextContentFromFile(int). It means a Part instance should only be immediately used if the position is near the current StringPart.begin position. The StringPartFromFileLines.readnextContentFromFile(int) let 1/3 of the StringPart.content accessible.

Field Summary

Fields

Modifier and Type	Field and Description
private int	absPos0 Absolute positions of part of chars
private int	b1 Absolute positions of part of chars
private int	e1 Absolute positions of part of chars
private StringPart	outer

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Part(StringPart outer, int from, int to) A subsequence

Method Summary

Modifier and Type	Method and Description
char	charAt(int index)
(package private) int	copyToBuffer(char[] dst, int from, int to) Copy to any other buffer to build persistent data.
boolean	equals(java.lang.Object cmp)
int	length()
protected void	setPart(int from, int to)
java.lang.CharSequence	subSequence(int from, int end)
java.lang.String	toString()
StringPart.Part	trim() Builds a new Part without leading and trailing white spaces.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.CharSequence

chars, codePoints

Field Detail

b1

private int b1

Absolute positions of part of chars

e1

private int e1

Absolute positions of part of chars

absPos0

private int absPos0

Absolute positions of part of chars

outer

private final StringPart outer

Constructor Detail

Part

protected Part(StringPart outer,
               int from,
               int to)

A subsequence

Parameters:

from - absolute positions

to -

Method Detail

setPart

protected void setPart(int from,
                       int to)

charAt

public final char charAt(int index)

Specified by:

charAt in interface java.lang.CharSequence

length

public final int length()

Specified by:

length in interface java.lang.CharSequence

equals

public final boolean equals(java.lang.Object cmp)

Overrides:

equals in class java.lang.Object

subSequence

public final java.lang.CharSequence subSequence(int from,
                                                int end)

Specified by:

subSequence in interface java.lang.CharSequence

toString

public final java.lang.String toString()

Specified by:

toString in interface java.lang.CharSequence

Overrides:

toString in class java.lang.Object

copyToBuffer

int copyToBuffer(char[] dst,
                 int from,
                 int to)

Copy to any other buffer to build persistent data.

Parameters:

dst - should be allocated with enough space, use this.length() to detect how much is necessary.

from - usual 0

Returns:

the number of copied character

trim

public final StringPart.Part trim()

Builds a new Part without leading and trailing white spaces. Without " \r\n\t"

Returns:

a new Part.