ZSONArray

java.lang.Object
- ohos.utils.zson.ZSONArray

```
public class ZSONArray
extends Object
```
Provides methods for processing JSON arrays.
This class encapsulates a JSON array based on the standard JSON data structure. In addition to data read and write, this class provides basic processing capabilities for the arrays, for example, traversing, querying, modifying, and deleting array elements.

从以下版本开始:

1

构造器概要

构造器
构造器	说明
`ZSONArray()`	Default constructor used to create a `ZSONArray` instance.
`ZSONArray(int initialCapacity)`	A constructor used to create a `ZSONArray` instance with a specified capacity.
`ZSONArray(List<Object> list)`	A constructor used to create a `ZSONArray` instance using a specified list.

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法	说明
`void`	`add(int index, Object element)`	Adds an `Element` object to the specified index in this `ZSONArray`.
`boolean`	`add(Object obj)`	Adds a specified `obj` object to this `ZSONArray`.
`boolean`	`addAll(int index, Collection<?> c)`	Adds the entire `c` object to this `ZSONArray` at the specified index.
`boolean`	`addAll(Collection<?> c)`	Adds the entire `c` object to this `ZSONArray`.
`void`	`clear()`	Clears this `ZSONArray`.
`Object`	`clone()`	Clones this `ZSONArray` object.
`boolean`	`contains(Object obj)`	Checks whether this `ZSONArray` contains an `obj` object.
`boolean`	`containsAll(Collection<?> c)`	Checks whether this `ZSONArray` contains a `c` object.
`Object`	`get(int index)`	Obtains the object at the specified index in this `ZSONArray`.
`BigDecimal`	`getBigDecimal(int index)`	Obtains the `BigDecimal` object at the specified index of this `ZSONArray`.
`BigInteger`	`getBigInteger(int index)`	Obtains the `BigInteger` object at the specified index of this `ZSONArray`.
`Boolean`	`getBoolean(int index)`	Obtains the `boolean` value at the specified index of this `ZSONArray` and automatically converts the value into a `Boolean` object.
`boolean`	`getBooleanValue(int index)`	Obtains the `boolean` value at the specified index of this `ZSONArray`.
`Byte`	`getByte(int index)`	Obtains the `byte` value at specified index of this `ZSONArray` and automatically converts the value into a `Byte` object.
`byte`	`getByteValue(int index)`	Obtains the `byte` value at the specified index of this `ZSONArray`.
`Date`	`getDate(int index)`	Obtains the `Date` object at the specified index of this `ZSONArray`.
`Double`	`getDouble(int index)`	Obtains the `double` value at the specified index of this `ZSONArray` and automatically converts the value into a `Double` object.
`double`	`getDoubleValue(int index)`	Obtains the `double` value at the specified index of this `ZSONArray`.
`Float`	`getFloat(int index)`	Obtains the `float` value at the specified index of this `ZSONArray` and automatically converts the value into a `Float` object.
`float`	`getFloatValue(int index)`	Obtains the `float` value at the specified index of this `ZSONArray`.
`Integer`	`getInteger(int index)`	Obtains the `int` value at the specified index of this `ZSONArray` and automatically converts the value into an `Integer` object.
`int`	`getIntValue(int index)`	Obtains the `int` value at the specified index of this `ZSONArray`.
`Long`	`getLong(int index)`	Obtains the `long` value at the specified index of this `ZSONArray` and automatically converts the value into a `Long` object.
`long`	`getLongValue(int index)`	Obtains the `long` value at the specified index of this `ZSONArray`.
`<T> T`	`getObject(int index, Class<T> clazz)`	Obtains the object at the specified index of this `ZSONArray` and converts it into a class object specified by `clazz`.
`Short`	`getShort(int index)`	Obtains the `short` value at the specified index of this `ZSONArray` and automatically converts the value into a `Short` object.
`short`	`getShortValue(int index)`	Obtains the `short` value at the specified index of this `ZSONArray`.
`String`	`getString(int index)`	Obtains the `String` object at the specified index of this `ZSONArray`.
`ZSONArray`	`getZSONArray(int index)`	Obtains the `ZSONArray` object at the specified index of this `ZSONArray`.
`ZSONObject`	`getZSONObject(int index)`	Obtains the `ZSONObject` at the specified index in this `ZSONArray`.
`int`	`indexOf(Object obj)`	Obtains the first index of the specified `obj` object in this `ZSONArray`.
`boolean`	`isEmpty()`	Checks whether this `ZSONArray` contains no object.
`Iterator<Object>`	`iterator()`	Obtains the `Iterator` objects of this `ZSONArray`.
`int`	`lastIndexOf(Object obj)`	Obtains the last index of the specified `obj` object in this `ZSONArray`.
`ListIterator<Object>`	`listIterator()`	Obtains the `ListIterator` objects of this `ZSONArray`.
`ListIterator<Object>`	`listIterator(int index)`	Obtains the `ListIterator` objects of this `ZSONArray` from the specified index.
`Object`	`remove(int index)`	Removes the object at the specified index in this `ZSONArray`.
`boolean`	`remove(Object obj)`	Removes the specified `obj` object from this `ZSONArray`.
`boolean`	`removeAll(Collection<?> c)`	Removes the entire `c` object from this `ZSONArray`.
`boolean`	`retainAll(Collection<?> c)`	Retains the entire `c` object when removing all other objects from this `ZSONArray`.
`Object`	`set(int index, Object element)`	Sets the object at the specified index in this `ZSONArray` to an `Element` object.
`int`	`size()`	Obtains the size of this `ZSONArray`.
`static <T> List<T>`	`stringToClassList(String text, Class<T> clazz)`	Convert the text to a class list.
`static ZSONArray`	`stringToZSONArray(String text)`	Convert the text to a `ZSONArray` object.
`List<Object>`	`subList(int fromIndex, int toIndex)`	Obtains the `ListIterator` objects of this `ZSONArray` within the specified index range.
`Object[]`	`toArray()`	Converts the objects stored in this `ZSONArray` into an array.
`<T> T[]`	`toArray(T[] a)`	Converts the objects stored in this `ZSONArray` into an array based on the specified template type `a`.
`<T> List<T>`	`toJavaList(Class<T> clazz)`	Converts a `ZSONArray` object into a list based on the specified `clazz` type.
`String`	`toString()`	Obtains the JSON-based string representation of the `ZSONArray` object.
`ZSONObject`	`toZSONObject(String[] keys)`	Pairs elements in this `ZSONArray` instance with the specified `keys` to form a `ZSONObject` object.

从类继承的方法 java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 构造器详细资料
  - ZSONArray
```
public ZSONArray()
```
    Default constructor used to create a ZSONArray instance.
    
    从以下版本开始:
    
    3
  - ZSONArray
```
public ZSONArray(List<Object> list)
```
    A constructor used to create a ZSONArray instance using a specified list.
    
    参数:
    
    list - Indicates the list used to create the ZSONArray instance.
    
    从以下版本开始:
    
    3
  - ZSONArray
```
public ZSONArray(int initialCapacity)
```
    A constructor used to create a ZSONArray instance with a specified capacity.
    
    参数:
    
    initialCapacity - Indicates the initial capacity of the ZSONArray instance to create. This parameter is also used to create a ArrayList<E>, and its maximum value is Integer.MAX_VALUE-8. If you set this parameter to a value larger than Integer.MAX_VALUE-8, the ZSONArray instance fails to be created.
    
    从以下版本开始:
    
    3
- 方法详细资料
  - stringToZSONArray
```
public static final ZSONArray stringToZSONArray(String text)
```
    Convert the text to a ZSONArray object.
    
    参数:
    
    text - The text to be converted.
    
    返回:
    
    Converted ZSONArray object.
    
    抛出:
    
    ZSONException - Throws this exception if the parser error.
    
    从以下版本开始:
    
    3
  - stringToClassList
```
public static final <T> List<T> stringToClassList(String text,
                                                  Class<T> clazz)
```
    Convert the text to a class list.
    
    类型参数:
    
    T - The class type convert to.
    
    参数:
    
    text - The text to be converted.
    
    clazz - The class convert to.
    
    返回:
    
    Converted class list.
    
    抛出:
    
    ZSONException - Throws this exception if the parser error.
    
    从以下版本开始:
    
    3
  - size
```
public int size()
```
    Obtains the size of this ZSONArray.
    
    返回:
    
    Returns the size of this ZSONArray.
    
    从以下版本开始:
    
    3
  - isEmpty
```
public boolean isEmpty()
```
    Checks whether this ZSONArray contains no object.
    
    返回:
    
    Returns true if this ZSONArray contains no object; returns false otherwise.
    
    从以下版本开始:
    
    3
  - contains
```
public boolean contains(Object obj)
```
    Checks whether this ZSONArray contains an obj object.
    
    参数:
    
    obj - Indicates the object to check.
    
    返回:
    
    Returns true if this ZSONArray contains an obj object; returns false otherwise.
    
    从以下版本开始:
    
    3
  - iterator
```
public Iterator<Object> iterator()
```
    Obtains the Iterator objects of this ZSONArray.
    
    返回:
    
    Returns the Iterator objects.
    
    从以下版本开始:
    
    3
  - toArray
```
public Object[] toArray()
```
    Converts the objects stored in this ZSONArray into an array.
    
    返回:
    
    Returns the converted array.
    
    从以下版本开始:
    
    3
  - toArray
```
public <T> T[] toArray(T[] a)
```
    Converts the objects stored in this ZSONArray into an array based on the specified template type a.
    
    参数:
    
    a - Indicates the template type used for converting the objects.
    
    返回:
    
    Returns the converted array.
    
    从以下版本开始:
    
    3
  - add
```
public boolean add(Object obj)
```
    Adds a specified obj object to this ZSONArray.
    
    参数:
    
    obj - Indicates the object to add.
    
    返回:
    
    Returns true if the object is successfully added; returns false otherwise.
    
    从以下版本开始:
    
    3
  - remove
```
public boolean remove(Object obj)
```
    Removes the specified obj object from this ZSONArray.
    
    参数:
    
    obj - Indicates the obj object to remove.
    
    返回:
    
    Returns true if the object is successfully removed; returns false otherwise.
    
    从以下版本开始:
    
    3
  - containsAll
```
public boolean containsAll(Collection<?> c)
```
    Checks whether this ZSONArray contains a c object.
    
    参数:
    
    c - Indicates the object to check.
    
    返回:
    
    Returns true if this ZSONArray contains a c object; returns false otherwise.
    
    从以下版本开始:
    
    3
  - addAll
```
public boolean addAll(Collection<?> c)
```
    Adds the entire c object to this ZSONArray.
    
    参数:
    
    c - Indicates the object to add.
    
    返回:
    
    Returns true if the object is successfully added; returns false otherwise.
    
    从以下版本开始:
    
    3
  - addAll
```
public boolean addAll(int index,
                      Collection<?> c)
```
    Adds the entire c object to this ZSONArray at the specified index.
    
    参数:
    
    index - Indicates the position to add the c object in this ZSONArray.
    
    c - Indicates the object to add.
    
    返回:
    
    Returns true if the object is successfully added; returns false otherwise.
    
    从以下版本开始:
    
    3
  - removeAll
```
public boolean removeAll(Collection<?> c)
```
    Removes the entire c object from this ZSONArray.
    
    参数:
    
    c - Indicates the object to remove.
    
    返回:
    
    Returns true if the object is successfully removed; returns false otherwise.
    
    从以下版本开始:
    
    3
  - retainAll
```
public boolean retainAll(Collection<?> c)
```
    Retains the entire c object when removing all other objects from this ZSONArray.
    
    参数:
    
    c - Indicates the object to retain.
    
    返回:
    
    Returns true if the object is successfully retained; returns false otherwise.
    
    从以下版本开始:
    
    3
  - clear
```
public void clear()
```
    Clears this ZSONArray.
    
    从以下版本开始:
    
    3
  - set
```
public Object set(int index,
                  Object element)
```
    Sets the object at the specified index in this ZSONArray to an Element object.
    
    参数:
    
    index - Indicates the position of the object to set in this ZSONArray.
    
    element - Indicates the Element object to set.
    
    返回:
    
    The element previously at the specified index.
    
    从以下版本开始:
    
    3
  - add
```
public void add(int index,
                Object element)
```
    Adds an Element object to the specified index in this ZSONArray.
    
    参数:
    
    index - Indicates the position to add the Element object in this ZSONArray.
    
    element - Indicates the Element object to add.
    
    从以下版本开始:
    
    3
  - remove
```
public Object remove(int index)
```
    Removes the object at the specified index in this ZSONArray.
    
    参数:
    
    index - Indicates the position of the object to remove from this ZSONArray.
    
    返回:
    
    Return the removed element previously at the specified index.
    
    从以下版本开始:
    
    3
  - indexOf
```
public int indexOf(Object obj)
```
    Obtains the first index of the specified obj object in this ZSONArray.
    
    参数:
    
    obj - Indicates the object to query.
    
    返回:
    
    Returns the first index of the specified object.
    
    从以下版本开始:
    
    3
  - lastIndexOf
```
public int lastIndexOf(Object obj)
```
    Obtains the last index of the specified obj object in this ZSONArray.
    
    参数:
    
    obj - Indicates the object to query.
    
    返回:
    
    Returns the last index of the specified object.
    
    从以下版本开始:
    
    3
  - listIterator
```
public ListIterator<Object> listIterator()
```
    Obtains the ListIterator objects of this ZSONArray.
    
    返回:
    
    Returns the ListIterator objects.
    
    从以下版本开始:
    
    3
  - listIterator
```
public ListIterator<Object> listIterator(int index)
```
    Obtains the ListIterator objects of this ZSONArray from the specified index.
    
    参数:
    
    index - Indicates the position to obtain the ListIterator objects.
    
    返回:
    
    Returns the ListIterator objects.
    
    从以下版本开始:
    
    3
  - subList
```
public List<Object> subList(int fromIndex,
                            int toIndex)
```
    Obtains the ListIterator objects of this ZSONArray within the specified index range.
    
    参数:
    
    fromIndex - Indicates the start position to obtain the ListIterator objects.
    
    toIndex - Indicates the end position to obtain the ListIterator objects.
    
    返回:
    
    Returns the ListIterator objects.
    
    从以下版本开始:
    
    3
  - get
```
public Object get(int index)
```
    Obtains the object at the specified index in this ZSONArray.
    
    参数:
    
    index - Indicates the position to obtain the object.
    
    返回:
    
    Returns the object at the specified index in this ZSONArray.
    
    从以下版本开始:
    
    3
  - getZSONObject
```
public ZSONObject getZSONObject(int index)
```
    Obtains the ZSONObject at the specified index in this ZSONArray.
    
    参数:
    
    index - Indicates the position to obtain the object.
    
    返回:
    
    Returns the ZSONObject at the specified index in this ZSONArray, or null when the object is not found.
    
    从以下版本开始:
    
    3
  - getZSONArray
```
public ZSONArray getZSONArray(int index)
```
    Obtains the ZSONArray object at the specified index of this ZSONArray.
    
    参数:
    
    index - Indicates the index of a ZSONArray stored in this ZSONArray.
    
    返回:
    
    Returns the ZSONArray at the specified index, or null when the array is not found.
    
    从以下版本开始:
    
    3
  - getObject
```
public <T> T getObject(int index,
                       Class<T> clazz)
```
    Obtains the object at the specified index of this ZSONArray and converts it into a class object specified by clazz.
    
    参数:
    
    index - Indicates the index of an object stored in this ZSONArray.
    
    clazz - Indicates the class type of the object to return. This object is converted from the value stored in this ZSONArray.
    
    返回:
    
    Returns the class object converted from the object at the specified index.
    
    从以下版本开始:
    
    3
  - getBoolean
```
public Boolean getBoolean(int index)
```
    Obtains the boolean value at the specified index of this ZSONArray and automatically converts the value into a Boolean object.
    
    参数:
    
    index - Indicates the index of a Boolean object stored in this ZSONArray.
    
    返回:
    
    Returns the Boolean object at the specified index.
    
    从以下版本开始:
    
    3
  - getBooleanValue
```
public boolean getBooleanValue(int index)
```
    Obtains the boolean value at the specified index of this ZSONArray.
    
    参数:
    
    index - Indicates the index of a boolean value stored in this ZSONArray.
    
    返回:
    
    Returns the boolean value at the specified index.
    
    从以下版本开始:
    
    3
  - getByte
```
public Byte getByte(int index)
```
    Obtains the byte value at specified index of this ZSONArray and automatically converts the value into a Byte object.
    
    参数:
    
    index - Indicates the index of a Byte object stored in this ZSONArray.
    
    返回:
    
    Returns the Byte object at the specified index.
    
    从以下版本开始:
    
    3
  - getByteValue
```
public byte getByteValue(int index)
```
    Obtains the byte value at the specified index of this ZSONArray.
    
    参数:
    
    index - Indicates the index of a byte value stored in this ZSONArray.
    
    返回:
    
    Returns the byte value at the specified index.
    
    从以下版本开始:
    
    3
  - getShort
```
public Short getShort(int index)
```
    Obtains the short value at the specified index of this ZSONArray and automatically converts the value into a Short object.
    
    参数:
    
    index - Indicates the index of a Short object stored in this ZSONArray.
    
    返回:
    
    Returns the Short object at the specified index.
    
    从以下版本开始:
    
    3
  - getShortValue
```
public short getShortValue(int index)
```
    Obtains the short value at the specified index of this ZSONArray.
    
    参数:
    
    index - Indicates the index of a short value in this ZSONArray.
    
    返回:
    
    Returns the short value at the specified index.
    
    从以下版本开始:
    
    3
  - getInteger
```
public Integer getInteger(int index)
```
    Obtains the int value at the specified index of this ZSONArray and automatically converts the value into an Integer object.
    
    参数:
    
    index - Indicates the index of a Integer value in this ZSONArray.
    
    返回:
    
    Returns the Integer object at the specified index.
    
    从以下版本开始:
    
    3
  - getIntValue
```
public int getIntValue(int index)
```
    Obtains the int value at the specified index of this ZSONArray.
    
    参数:
    
    index - Indicates the index of a int value stored in this ZSONArray.
    
    返回:
    
    Returns the int value at the specified index.
    
    从以下版本开始:
    
    3
  - getLong
```
public Long getLong(int index)
```
    Obtains the long value at the specified index of this ZSONArray and automatically converts the value into a Long object.
    
    参数:
    
    index - Indicates the index of a Long object stored in this ZSONArray.
    
    返回:
    
    Returns the Long object at the specified index.
    
    从以下版本开始:
    
    3
  - getLongValue
```
public long getLongValue(int index)
```
    Obtains the long value at the specified index of this ZSONArray.
    
    参数:
    
    index - Indicates the index of a Long value stored in this ZSONArray.
    
    返回:
    
    Returns the long value at the specified index.
    
    从以下版本开始:
    
    3
  - getFloat
```
public Float getFloat(int index)
```
    Obtains the float value at the specified index of this ZSONArray and automatically converts the value into a Float object.
    
    参数:
    
    index - Indicates the index of a Float object stored in this ZSONArray.
    
    返回:
    
    Returns the Float object at the specified index.
    
    从以下版本开始:
    
    3
  - getFloatValue
```
public float getFloatValue(int index)
```
    Obtains the float value at the specified index of this ZSONArray.
    
    参数:
    
    index - Indicates the index of a float value stored in this ZSONArray.
    
    返回:
    
    Returns the float value at the specified index.
    
    从以下版本开始:
    
    3
  - getDouble
```
public Double getDouble(int index)
```
    Obtains the double value at the specified index of this ZSONArray and automatically converts the value into a Double object.
    
    参数:
    
    index - Indicates the index of a Double object stored in this ZSONArray.
    
    返回:
    
    Returns the Double object at the specified index.
    
    从以下版本开始:
    
    3
  - getDoubleValue
```
public double getDoubleValue(int index)
```
    Obtains the double value at the specified index of this ZSONArray.
    
    参数:
    
    index - Indicates the index of a double value stored in this ZSONArray.
    
    返回:
    
    Returns the double value at the specified index.
    
    从以下版本开始:
    
    3
  - getBigDecimal
```
public BigDecimal getBigDecimal(int index)
```
    Obtains the BigDecimal object at the specified index of this ZSONArray.
    
    参数:
    
    index - Indicates the index of a BigDecimal object stored in this ZSONArray.
    
    返回:
    
    Returns the BigDecimal object at the specified index.
    
    从以下版本开始:
    
    3
  - getBigInteger
```
public BigInteger getBigInteger(int index)
```
    Obtains the BigInteger object at the specified index of this ZSONArray.
    
    参数:
    
    index - Indicates the index of a BigInteger object stored in this ZSONArray.
    
    返回:
    
    Returns the BigInteger object at the specified index.
    
    从以下版本开始:
    
    3
  - getString
```
public String getString(int index)
```
    Obtains the String object at the specified index of this ZSONArray.
    
    参数:
    
    index - Indicates the index of a String object stored in this ZSONArray.
    
    返回:
    
    Returns the String object at the specified index.
    
    从以下版本开始:
    
    3
  - getDate
```
public Date getDate(int index)
```
    Obtains the Date object at the specified index of this ZSONArray.
    
    参数:
    
    index - Indicates the index of a Date object stored in this ZSONArray.
    
    返回:
    
    Returns the Date object at the specified index.
    
    从以下版本开始:
    
    3
  - clone
```
public Object clone()
```
    Clones this ZSONArray object.
    
    覆盖:
    
    clone 在类中 Object
    
    返回:
    
    Returns the clone of this ZSONArray object.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    Cloneable
  - toJavaList
```
public <T> List<T> toJavaList(Class<T> clazz)
```
    Converts a ZSONArray object into a list based on the specified clazz type.
    
    参数:
    
    clazz - Indicates the class type for converting the ZSONArray object.
    
    返回:
    
    Returns the converted list.
    
    从以下版本开始:
    
    3
  - toZSONObject
```
public ZSONObject toZSONObject(String[] keys)
```
    Pairs elements in this ZSONArray instance with the specified keys to form a ZSONObject object.
    If the length of keys does not match the length of elements in this ZSONArray instance, the smaller length is used. Elements in the returned object are arranged in accordance with the sequence of keys.
    
    参数:
    
    keys - Indicates the keys used to match the elements in this ZSONArray instance.
    
    返回:
    
    Returns the ZSONObject object.
    
    抛出:
    
    NullPointerException - Throws this exception if keys is null.
    
    从以下版本开始:
    
    4
  - toString
```
public String toString()
```
    Obtains the JSON-based string representation of the ZSONArray object.
    
    覆盖:
    
    toString 在类中 Object
    
    返回:
    
    Returns the JSON-based string representation of ZSONArray.
    
    从以下版本开始:
    
    5

类 ZSONArray

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

ZSONArray

ZSONArray

ZSONArray

方法详细资料

stringToZSONArray

stringToClassList

size

isEmpty

contains

iterator

toArray

toArray

add

remove

containsAll

addAll

addAll

removeAll

retainAll

clear

set

add

remove

indexOf

lastIndexOf

listIterator

listIterator

subList

get

getZSONObject

getZSONArray

getObject

getBoolean

getBooleanValue

getByte

getByteValue

getShort

getShortValue

getInteger

getIntValue

getLong

getLongValue

getFloat

getFloatValue

getDouble

getDoubleValue

getBigDecimal

getBigInteger

getString

getDate

clone

toJavaList

toZSONObject

toString