RunArray (kfc 1.2.0 API)

java.lang.Object
- jp.kyasu.util.RunArray

すべての実装されたインタフェース:

java.io.Serializable, java.lang.Cloneable
```
public class RunArray
extends java.lang.Object
implements java.lang.Cloneable, java.io.Serializable
```
The RunArray class implements a space-efficient growable array that tends to be constant over long runs of the possible indices.

関連項目:

直列化された形式

フィールドのサマリー

フィールド
修飾子とタイプ	フィールドと説明
`protected int`	`cacheRunIndex` The cache index of `runs`.
`protected int`	`cacheRunStart` The cache index of the `RunArray` (Sum of run lengths up to `cacheRunIndex`).
`protected int`	`count` The number of valid components in the array (Sum of run lengths).
`protected VArray`	`runs` The buffer of the run length.
`protected VArray`	`values` The value buffer into which the components of the array are stored.

コンストラクタのサマリー

コンストラクタ
修飾子	コンストラクタと説明
	`RunArray()` Constructs an empty array.
	`RunArray(java.lang.Class componentType)` Constructs an empty array with the specified component type.
	`RunArray(int size, java.lang.Object value)` Constructs an array with the specified size (length), whose every component equals to the specified value.
	`RunArray(int size, java.lang.Object value, java.lang.Class componentType)` Constructs an array with the specified size (length), whose every component equals to the specified value.
`protected`	`RunArray(VArray runs, VArray values, int count)` Constructs an array with the specified runs, values, and count.

メソッドのサマリー

すべてのメソッドインスタンス・メソッド concreteメソッド
修飾子とタイプ	メソッドと説明
`RunArray`	`append(int length, java.lang.Object defObj)` Grows the length of this array to the current array's length plus the specified `length`.
`RunArray`	`append(java.lang.Object obj)` Appends the object to this array.
`RunArray`	`append(RunArray array)` Appends the components of the `RunArray` object to this array.
`java.lang.Object`	`clone()` Returns a clone of this array.
`protected void`	`copyFrom(RunArray array)` Copies into the contents of this array from the specified array.
`java.util.Enumeration`	`elements()` Returns an enumeration of the components of this array.
`java.util.Enumeration`	`elements(int begin, int end)` Returns an enumeration of the components of this array.
`boolean`	`equals(java.lang.Object anObject)` Compares two Objects for equality.
`java.lang.Object`	`get(int index)` Returns the component object at the specified index.
`java.lang.Class`	`getComponentType()` Returns the component type of this array.
`protected int[]`	`getRunAndOffset(int index)` Returns the run length and the run offset at the specified index.
`int`	`getRunLengthAt(int index)` Returns the run length (the number of the constant occurrence) at the specified index.
`int`	`getRunOffsetAt(int index)` Returns the run offset (the starting index of the constant occurrence) at the specified index.
`int`	`getValueCount()` Returns the number of the components in this array.
`java.lang.Object[]`	`getValues()` Returns the components in this array.
`java.lang.Object[]`	`getValues(int begin, int end)` Returns the components in this array.
`int`	`hashCode()` Returns a hashcode for this array.
`RunArray`	`insert(int offset, RunArray array)` Inserts the components of the `RunArray` object to this array from the specified `offset`.
`boolean`	`isEmpty()` Tests if this array has no components.
`int`	`length()` Returns the length of this array, i.e., the number of components in this array.
`void`	`remove(int offset, int size)` Removes the components in this array from the specified `offset`.
`void`	`removeAll()` Removes all components from this array and sets its length to zero.
`protected void`	`replace(int bRun, int bOffset, int eRun, int eOffset, VArray rRuns, VArray rValues)` Replaces the components of this array with the runs and values.
`RunArray`	`replace(int begin, int end, RunArray array)` Replaces the components of this array with the components of the `RunArray` object.
`int`	`size()` Returns the size of this array, i.e., the number of components in this array.
`RunArray`	`subarray(int beginIndex)` Returns a new array that is a subarray of this array.
`RunArray`	`subarray(int beginIndex, int endIndex)` Returns a new array that is a subarray of this array.
`java.lang.String`	`toString()` Returns a string representation of this array.

クラスから継承されたメソッド java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait

- フィールドの詳細
  - runs
```
protected VArray runs
```
    The buffer of the run length. Each indicates the number of indices over which the corresponding value (in values) is constant.
  - values
```
protected VArray values
```
    The value buffer into which the components of the array are stored.
  - count
```
protected int count
```
    The number of valid components in the array (Sum of run lengths).
  - cacheRunIndex
```
protected int cacheRunIndex
```
    The cache index of runs.
  - cacheRunStart
```
protected int cacheRunStart
```
    The cache index of the RunArray (Sum of run lengths up to cacheRunIndex).
- コンストラクタの詳細
  - RunArray
```
public RunArray()
```
    Constructs an empty array.
  - RunArray
```
public RunArray(java.lang.Class componentType)
```
    Constructs an empty array with the specified component type.
    
    パラメータ:
    
    componentType - the component type of the array.
    
    例外:
    
    java.lang.IllegalArgumentException - if the specified component type is a primitive type.
  - RunArray
```
public RunArray(int size,
                java.lang.Object value)
```
    Constructs an array with the specified size (length), whose every component equals to the specified value.
    
    パラメータ:
    
    size - the size (length) of the array.
    
    value - the components of the array.
  - RunArray
```
public RunArray(int size,
                java.lang.Object value,
                java.lang.Class componentType)
```
    Constructs an array with the specified size (length), whose every component equals to the specified value.
    
    パラメータ:
    
    size - the size (length) of the array.
    
    value - the components of the array.
    
    componentType - the component type of the array.
    
    例外:
    
    java.lang.IllegalArgumentException - if the specified component type is a primitive type.
  - RunArray
```
protected RunArray(VArray runs,
                   VArray values,
                   int count)
```
    Constructs an array with the specified runs, values, and count.
    
    パラメータ:
    
    runs - the run length array of the array.
    
    values - the value array of the array.
    
    count - the count of the array.
- メソッドの詳細
  - size
```
public final int size()
```
    Returns the size of this array, i.e., the number of components in this array.
    
    戻り値:
    
    the size of this array.
  - length
```
public final int length()
```
    Returns the length of this array, i.e., the number of components in this array.
    
    戻り値:
    
    the length of this array.
  - isEmpty
```
public final boolean isEmpty()
```
    Tests if this array has no components.
    
    戻り値:
    
    true if this array has no components; false otherwise.
  - elements
```
public final java.util.Enumeration elements()
```
    Returns an enumeration of the components of this array.
    
    戻り値:
    
    an enumeration of the components of this array.
  - elements
```
public final java.util.Enumeration elements(int begin,
                                            int end)
```
    Returns an enumeration of the components of this array.
    
    パラメータ:
    
    begin - the beginning index to get components, inclusive.
    
    end - the ending index to get components, exclusive.
    
    戻り値:
    
    an enumeration of the components of this array.
    
    例外:
    
    java.lang.ArrayIndexOutOfBoundsException - if the begin, or the end is out of range.
  - getComponentType
```
public final java.lang.Class getComponentType()
```
    Returns the component type of this array.
    
    戻り値:
    
    the component type of this array.
  - getValueCount
```
public final int getValueCount()
```
    Returns the number of the components in this array.
    
    戻り値:
    
    the number of the components in this array.
  - getValues
```
public final java.lang.Object[] getValues()
```
    Returns the components in this array.
    
    戻り値:
    
    the components in this array.
  - getValues
```
public final java.lang.Object[] getValues(int begin,
                                          int end)
```
    Returns the components in this array.
    
    パラメータ:
    
    begin - the beginning index to get components, inclusive.
    
    end - the ending index to get components, exclusive.
    
    戻り値:
    
    the components in this array.
    
    例外:
    
    java.lang.ArrayIndexOutOfBoundsException - if the begin, or the end is out of range.
  - get
```
public final java.lang.Object get(int index)
```
    Returns the component object at the specified index.
    
    パラメータ:
    
    index - an index into this array.
    
    戻り値:
    
    the component at the specified index.
    
    例外:
    
    java.lang.ArrayIndexOutOfBoundsException - if an invalid index was given.
  - getRunLengthAt
```
public final int getRunLengthAt(int index)
```
    Returns the run length (the number of the constant occurrence) at the specified index.
    
    パラメータ:
    
    index - an index into this array.
    
    戻り値:
    
    the run length from the specified index.
    
    例外:
    
    java.lang.ArrayIndexOutOfBoundsException - if an invalid index was given.
  - getRunOffsetAt
```
public final int getRunOffsetAt(int index)
```
    Returns the run offset (the starting index of the constant occurrence) at the specified index.
    
    パラメータ:
    
    index - an index into this array.
    
    戻り値:
    
    the run offset from the specified index.
    
    例外:
    
    java.lang.ArrayIndexOutOfBoundsException - if an invalid index was given.
  - hashCode
```
public int hashCode()
```
    Returns a hashcode for this array.
    
    オーバーライド:
    
    hashCode クラス内 java.lang.Object
    
    戻り値:
    
    a hash code value for this array.
  - equals
```
public boolean equals(java.lang.Object anObject)
```
    Compares two Objects for equality.
    
    オーバーライド:
    
    equals クラス内 java.lang.Object
    
    パラメータ:
    
    anObject - the reference object with which to compare.
    
    戻り値:
    
    true if this array is the same as the anObject argument; false otherwise.
  - removeAll
```
public final void removeAll()
```
    Removes all components from this array and sets its length to zero.
  - remove
```
public final void remove(int offset,
                         int size)
```
    Removes the components in this array from the specified offset. The number of the components to be removed is specified by the size. Each component in this array with an index greater or equal to offset+size is shifted downward.
    
    パラメータ:
    
    offset - the start index of the components to be removed.
    
    size - the number of the components to be removed.
    
    例外:
    
    java.lang.ArrayIndexOutOfBoundsException - if the offset or the size were invalid.
  - subarray
```
public final RunArray subarray(int beginIndex)
```
    Returns a new array that is a subarray of this array. The subarray begins at the specified index and extends to the end of this array.
    
    パラメータ:
    
    beginIndex - the beginning index, inclusive.
    
    戻り値:
    
    the subarray.
    
    例外:
    
    java.lang.ArrayIndexOutOfBoundsException - if the beginIndex is out of range.
  - subarray
```
public final RunArray subarray(int beginIndex,
                               int endIndex)
```
    Returns a new array that is a subarray of this array. The subarray begins at the specified beginIndex and extends to the component at index endIndex-1.
    
    パラメータ:
    
    beginIndex - the beginning index, inclusive.
    
    endIndex - the ending index, exclusive.
    
    戻り値:
    
    the subarray.
    
    例外:
    
    java.lang.ArrayIndexOutOfBoundsException - if the beginIndex or the endIndex is out of range.
  - append
```
public final RunArray append(RunArray array)
```
    Appends the components of the RunArray object to this array.
    
    パラメータ:
    
    array - an RunArray object.
    
    戻り値:
    
    this array.
  - append
```
public final RunArray append(java.lang.Object obj)
```
    Appends the object to this array.
    
    パラメータ:
    
    obj - an object.
    
    戻り値:
    
    this array.
  - append
```
public final RunArray append(int length,
                             java.lang.Object defObj)
```
    Grows the length of this array to the current array's length plus the specified length. If this array isn't empty, the last value is added to the end of the array. Otherwise, defObj is added to the end of the array.
    
    パラメータ:
    
    length - object.
    
    defObj - an object.
    
    戻り値:
    
    this array.
  - insert
```
public final RunArray insert(int offset,
                             RunArray array)
```
    Inserts the components of the RunArray object to this array from the specified offset.
    
    パラメータ:
    
    offset - the start index of the components to be inserted.
    
    array - a RunArray object.
    
    戻り値:
    
    this array.
    
    例外:
    
    java.lang.ArrayIndexOutOfBoundsException - if the offset was invalid.
  - replace
```
public final RunArray replace(int begin,
                              int end,
                              RunArray array)
```
    Replaces the components of this array with the components of the RunArray object.
    
    パラメータ:
    
    begin - the beginning index to replace, inclusive.
    
    end - the ending index to replace, exclusive.
    
    array - a replacement RunArray object.
    
    戻り値:
    
    this array.
    
    例外:
    
    java.lang.ArrayIndexOutOfBoundsException - if the begin or the end is out of range.
  - toString
```
public java.lang.String toString()
```
    Returns a string representation of this array.
    
    オーバーライド:
    
    toString クラス内 java.lang.Object
    
    戻り値:
    
    a string representation of this array.
  - clone
```
public java.lang.Object clone()
```
    Returns a clone of this array.
    
    オーバーライド:
    
    clone クラス内 java.lang.Object
    
    戻り値:
    
    a clone of this array.
  - getRunAndOffset
```
protected final int[] getRunAndOffset(int index)
```
    Returns the run length and the run offset at the specified index.
  - replace
```
protected final void replace(int bRun,
                             int bOffset,
                             int eRun,
                             int eOffset,
                             VArray rRuns,
                             VArray rValues)
```
    Replaces the components of this array with the runs and values.
    
    パラメータ:
    
    bRun - the beginning index of runs, inclusive.
    
    bOffset - the beginning offset of runs.
    
    eRun - the ending index of runs, inclusive.
    
    eOffset - the ending offset of runs.
    
    rRuns - a run length array.
    
    rValues - a value array.
  - copyFrom
```
protected final void copyFrom(RunArray array)
```
    Copies into the contents of this array from the specified array.

クラス RunArray

フィールドのサマリー

コンストラクタのサマリー

メソッドのサマリー

クラスから継承されたメソッド java.lang.Object

フィールドの詳細

runs

values

count

cacheRunIndex

cacheRunStart

コンストラクタの詳細

RunArray

RunArray

RunArray

RunArray

RunArray

メソッドの詳細

size

length

isEmpty

elements

elements

getComponentType

getValueCount

getValues

getValues

get

getRunLengthAt

getRunOffsetAt

hashCode

equals

removeAll

remove

subarray

subarray

append

append

append

insert

replace

toString

clone

getRunAndOffset

replace

copyFrom