CharArray (libGDX Core 1.4.1 API)

java.lang.Object
- com.badlogic.gdx.utils.CharArray

```
public class CharArray
extends Object
```
A resizable, ordered or unordered char array. Avoids the boxing that occurs with ArrayList. If unordered, this class avoids a memory copy when removing elements (the last element is moved to the removed element's position).

Author:

Nathan Sweet

Field Summary

Fields
Modifier and Type Field and Description

char[] items

boolean ordered

int size

Fields
Modifier and Type	Field and Description
`char[]`	`items`
`boolean`	`ordered`
`int`	`size`

Constructor Summary

Constructors
Constructor and Description
`CharArray()` Creates an ordered array with a capacity of 16.
`CharArray(boolean ordered, char[] array, int startIndex, int count)` Creates a new array containing the elements in the specified array.
`CharArray(boolean ordered, int capacity)`
`CharArray(char[] array)` Creates a new ordered array containing the elements in the specified array.
`CharArray(CharArray array)` Creates a new array containing the elements in the specific array.
`CharArray(int capacity)` Creates an ordered array with the specified capacity.

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`add(char value)`
`void`	`addAll(char... array)`
`void`	`addAll(char[] array, int offset, int length)`
`void`	`addAll(CharArray array)`
`void`	`addAll(CharArray array, int offset, int length)`
`void`	`clear()`
`boolean`	`contains(char value)`
`char[]`	`ensureCapacity(int additionalCapacity)` Increases the size of the backing array to accommodate the specified number of additional items.
`boolean`	`equals(Object object)`
`char`	`first()` Returns the first item.
`char`	`get(int index)`
`void`	`incr(int index, char value)`
`int`	`indexOf(char value)`
`void`	`insert(int index, char value)`
`int`	`lastIndexOf(char value)`
`void`	`mul(int index, char value)`
`char`	`peek()` Returns the last item.
`char`	`pop()` Removes and returns the last item.
`char`	`random()` Returns a random item from the array, or zero if the array is empty.
`boolean`	`removeAll(CharArray array)` Removes from this array all of elements contained in the specified array.
`char`	`removeIndex(int index)` Removes and returns the item at the specified index.
`void`	`removeRange(int start, int end)` Removes the items between the specified indices, inclusive.
`boolean`	`removeValue(char value)`
`void`	`reverse()`
`void`	`set(int index, char value)`
`char[]`	`shrink()` Reduces the size of the backing array to the size of the actual items.
`void`	`shuffle()`
`void`	`sort()`
`void`	`swap(int first, int second)`
`char[]`	`toArray()`
`String`	`toString()`
`String`	`toString(String separator)`
`void`	`truncate(int newSize)` Reduces the size of the array to the specified size.
`static CharArray`	`with(char... array)`

Methods inherited from class java.lang.Object
getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - items
```
public char[] items
```
  - size
```
public int size
```
  - ordered
```
public boolean ordered
```
- Constructor Detail
  - CharArray
```
public CharArray()
```
    Creates an ordered array with a capacity of 16.
  - CharArray
```
public CharArray(int capacity)
```
    Creates an ordered array with the specified capacity.
  - CharArray
```
public CharArray(boolean ordered,
         int capacity)
```
    Parameters:
    ordered - If false, methods that remove elements may change the order of other elements in the array, which avoids a memory copy.
    capacity - Any elements added beyond this will cause the backing array to be grown.
  - CharArray
```
public CharArray(CharArray array)
```
    Creates a new array containing the elements in the specific array. The new array will be ordered if the specific array is ordered. The capacity is set to the number of elements, so any subsequent elements added will cause the backing array to be grown.
  - CharArray
```
public CharArray(char[] array)
```
    Creates a new ordered array containing the elements in the specified array. The capacity is set to the number of elements, so any subsequent elements added will cause the backing array to be grown.
  - CharArray
```
public CharArray(boolean ordered,
         char[] array,
         int startIndex,
         int count)
```
    Creates a new array containing the elements in the specified array. The capacity is set to the number of elements, so any subsequent elements added will cause the backing array to be grown.
    
    Parameters:
    ordered - If false, methods that remove elements may change the order of other elements in the array, which avoids a memory copy.
- Method Detail
  - add
```
public void add(char value)
```
  - addAll
```
public void addAll(CharArray array)
```
  - addAll
```
public void addAll(CharArray array,
          int offset,
          int length)
```
  - addAll
```
public void addAll(char... array)
```
  - addAll
```
public void addAll(char[] array,
          int offset,
          int length)
```
  - get
```
public char get(int index)
```
  - set
```
public void set(int index,
       char value)
```
  - incr
```
public void incr(int index,
        char value)
```
  - mul
```
public void mul(int index,
       char value)
```
  - insert
```
public void insert(int index,
          char value)
```
  - swap
```
public void swap(int first,
        int second)
```
  - contains
```
public boolean contains(char value)
```
  - indexOf
```
public int indexOf(char value)
```
  - lastIndexOf
```
public int lastIndexOf(char value)
```
  - removeValue
```
public boolean removeValue(char value)
```
  - removeIndex
```
public char removeIndex(int index)
```
    Removes and returns the item at the specified index.
  - removeRange
```
public void removeRange(int start,
               int end)
```
    Removes the items between the specified indices, inclusive.
  - removeAll
```
public boolean removeAll(CharArray array)
```
    Removes from this array all of elements contained in the specified array.
    
    Returns:
    true if this array was modified.
  - pop
```
public char pop()
```
    Removes and returns the last item.
  - peek
```
public char peek()
```
    Returns the last item.
  - first
```
public char first()
```
    Returns the first item.
  - clear
```
public void clear()
```
  - shrink
```
public char[] shrink()
```
    Reduces the size of the backing array to the size of the actual items. This is useful to release memory when many items have been removed, or if it is known that more items will not be added.
    
    Returns:
    items
  - ensureCapacity
```
public char[] ensureCapacity(int additionalCapacity)
```
    Increases the size of the backing array to accommodate the specified number of additional items. Useful before adding many items to avoid multiple backing array resizes.
    
    Returns:
    items
  - sort
```
public void sort()
```
  - reverse
```
public void reverse()
```
  - shuffle
```
public void shuffle()
```
  - truncate
```
public void truncate(int newSize)
```
    Reduces the size of the array to the specified size. If the array is already smaller than the specified size, no action is taken.
  - random
```
public char random()
```
    Returns a random item from the array, or zero if the array is empty.
  - toArray
```
public char[] toArray()
```
  - equals
```
public boolean equals(Object object)
```
    Overrides:
    
    equals in class Object
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - toString
```
public String toString(String separator)
```
  - with
```
public static CharArray with(char... array)
```
    See Also:
    CharArray(char[])

Class CharArray

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

items

size

ordered

Constructor Detail

CharArray

CharArray

CharArray

CharArray

CharArray

CharArray

Method Detail

add

addAll

addAll

addAll

addAll

get

set

incr

mul

insert

swap

contains

indexOf

lastIndexOf

removeValue

removeIndex

removeRange

removeAll

pop

peek

first

clear

shrink

ensureCapacity

sort

reverse

shuffle

truncate

random

toArray

equals

toString

toString

with