ArrayStructure (All javadoc for netcdf-java version 4.6.22-SNAPSHOT)

java.lang.Object
- ucar.ma2.Array
- - ucar.ma2.ArrayStructure

Direct Known Subclasses:

ArraySequence, ArraySequenceNested, ArrayStructureBB, ArrayStructureComposite, ArrayStructureMA, ArrayStructureW, CDMArrayStructure
```
public abstract class ArrayStructure
extends Array
```
Superclass for implementations of Array of StructureData.
The general way to access data in an ArrayStructure is to use
```
 StructureData getStructureData(Index index).
```
For 1D arrays (or by calculating your own recnum for nD arrays), you can also use:
```
 StructureData getStructureData(int recnum).
```
Once you have a StructureData object, you can access data in a general way by using:
```
 Array StructureData.getArray(Member m) 
```
When dealing with large arrays of Structures, there can be significant overhead in using the generic interfaces. A number of convenience routines may be able to avoid extra Object creation, and so are recommended for efficiency. The following may avoid the overhead of creating the StructureData object:
```
 Array getArray(int recno, StructureMembers.Member m) 
```
The following can be convenient for accessing all the data in the ArrayStructure for one member, but its efficiency depends on the implementation:
```
 Array getMemberArray(StructureMembers.Member m) 
```
These require that you know the data types of the member data, but they are the most efficent:
```
 getScalarXXX(int recnum, Member m)
 getJavaArrayXXX(int recnum, Member m) 
```
where XXX is Byte, Char, Double, Float, Int, Long, Short, or String. For members that are themselves Structures, the equivilent is:
```
 StructureData getScalarStructure(int recnum, Member m)
 ArrayStructure getArrayStructure(int recnum, Member m) 
```
These will return any compatible type as a double or float, but will have extra overhead when the types dont match:
```
 convertScalarXXX(int recnum, Member m)
 convertJavaArrayXXX(int recnum, Member m) 
```
where XXX is Double or Float
See Also:

Array, StructureData

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

class ArrayStructure.ArrayStructureIterator

Nested Classes
Modifier and Type	Class and Description
`class`	`ArrayStructure.ArrayStructureIterator`

Field Summary

Fields
Modifier and Type Field and Description

protected StructureMembers members

protected int nelems

protected StructureData[] sdata
- Fields inherited from class ucar.ma2.Array
  indexCalc, rank, unsigned

Fields
Modifier and Type	Field and Description
`protected StructureMembers`	`members`
`protected int`	`nelems`
`protected StructureData[]`	`sdata`

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`ArrayStructure(StructureMembers members, Index ima)`
`protected`	`ArrayStructure(StructureMembers members, int[] shape)` Create a new Array of type StructureData and the given members and shape.

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`double`	`convertScalarDouble(int recnum, StructureMembers.Member m)` Get scalar value as a double, with conversion as needed.
`float`	`convertScalarFloat(int recnum, StructureMembers.Member m)` Get scalar value as a float, with conversion as needed.
`int`	`convertScalarInt(int recnum, StructureMembers.Member m)` Get scalar value as an int, with conversion as needed.
`long`	`convertScalarLong(int recnum, StructureMembers.Member m)`
`Array`	`copy()` DO NOT USE, throws UnsupportedOperationException
`protected void`	`copyBytes(int recnum, StructureMembers.Member m, IndexIterator result)`
`protected void`	`copyChars(int recnum, StructureMembers.Member m, IndexIterator result)`
`protected void`	`copyDoubles(int recnum, StructureMembers.Member m, IndexIterator result)`
`protected void`	`copyFloats(int recnum, StructureMembers.Member m, IndexIterator result)`
`protected void`	`copyFrom1DJavaArray(IndexIterator iter, java.lang.Object javaArray)`
`protected void`	`copyInts(int recnum, StructureMembers.Member m, IndexIterator result)`
`protected void`	`copyLongs(int recnum, StructureMembers.Member m, IndexIterator result)`
`protected void`	`copyObjects(int recnum, StructureMembers.Member m, IndexIterator result)`
`protected void`	`copySequences(int recnum, StructureMembers.Member m, IndexIterator result)`
`protected void`	`copyShorts(int recnum, StructureMembers.Member m, IndexIterator result)`
`protected void`	`copyStructures(int recnum, StructureMembers.Member m, IndexIterator result)`
`protected void`	`copyTo1DJavaArray(IndexIterator iter, java.lang.Object javaArray)`
`Array`	`createView(Index index)` create new Array with given Index and the same backing store
`Array`	`extractMemberArray(StructureMembers.Member m)` Extract data for one member, over all structures.
`StructureMembers.Member`	`findMember(java.lang.String memberName)` Find a member by its name.
`Array`	`getArray(int recno, StructureMembers.Member m)` Get member data of any type for a specific record as an Array.
`ArrayObject`	`getArrayObject(int recnum, StructureMembers.Member m)` Get member data of type ArrayObject
`ArraySequence`	`getArraySequence(int recnum, StructureMembers.Member m)` Get member data of type ArraySequence
`ArrayStructure`	`getArrayStructure(int recnum, StructureMembers.Member m)` Get member data of type array of Structure.
`boolean`	`getBoolean(Index i)` DO NOT USE, throw ForbiddenConversionException
`boolean`	`getBoolean(int index)`
`byte`	`getByte(Index i)` DO NOT USE, throw ForbiddenConversionException
`byte`	`getByte(int index)`
`char`	`getChar(Index i)` DO NOT USE, throw ForbiddenConversionException
`char`	`getChar(int index)`
`double`	`getDouble(Index i)` DO NOT USE, throw ForbiddenConversionException
`double`	`getDouble(int index)`
`java.lang.Class`	`getElementType()` Get the element class type of this Array
`float`	`getFloat(Index i)` DO NOT USE, throw ForbiddenConversionException
`float`	`getFloat(int index)`
`int`	`getInt(Index i)` DO NOT USE, throw ForbiddenConversionException
`int`	`getInt(int index)`
`byte[]`	`getJavaArrayByte(int recnum, StructureMembers.Member m)` Get member data of type byte as a 1D array.
`char[]`	`getJavaArrayChar(int recnum, StructureMembers.Member m)` Get member data of type char as a 1D array.
`double[]`	`getJavaArrayDouble(int recnum, StructureMembers.Member m)` Get member data of type double as a 1D array.
`float[]`	`getJavaArrayFloat(int recnum, StructureMembers.Member m)` Get member data of type float as a 1D array.
`int[]`	`getJavaArrayInt(int recnum, StructureMembers.Member m)` Get member data of type int as a 1D array.
`long[]`	`getJavaArrayLong(int recnum, StructureMembers.Member m)` Get member data of type long as a 1D array.
`short[]`	`getJavaArrayShort(int recnum, StructureMembers.Member m)` Get member data of type short as a 1D array.
`java.lang.String[]`	`getJavaArrayString(int recnum, StructureMembers.Member m)` Get member data of type String as a 1D array.
`long`	`getLong(Index i)` DO NOT USE, throw ForbiddenConversionException
`long`	`getLong(int index)`
`java.util.List<StructureMembers.Member>`	`getMembers()` Get a list of structure members.
`java.lang.Object`	`getObject(Index i)` Get the index-th StructureData of this ArrayStructure.
`java.lang.Object`	`getObject(int index)` Get the index-th StructureData of this ArrayStructure.
`byte`	`getScalarByte(int recnum, StructureMembers.Member m)` Get scalar member data of type byte.
`char`	`getScalarChar(int recnum, StructureMembers.Member m)` Get scalar member data of type char.
`double`	`getScalarDouble(int recnum, StructureMembers.Member m)` Get scalar member data of type double.
`float`	`getScalarFloat(int recnum, StructureMembers.Member m)` Get scalar member data of type float.
`int`	`getScalarInt(int recnum, StructureMembers.Member m)` Get scalar member data of type int.
`long`	`getScalarLong(int recnum, StructureMembers.Member m)` Get scalar member data of type long.
`java.lang.Object`	`getScalarObject(int recno, StructureMembers.Member m)` Get member data array of any type as an Object, eg, Float, Double, String, StructureData etc.
`short`	`getScalarShort(int recnum, StructureMembers.Member m)` Get scalar member data of type short.
`java.lang.String`	`getScalarString(int recnum, StructureMembers.Member m)` Get member data of type String or char.
`StructureData`	`getScalarStructure(int recnum, StructureMembers.Member m)` Get member data of type Structure.
`short`	`getShort(Index i)` DO NOT USE, throw ForbiddenConversionException
`short`	`getShort(int index)`
`long`	`getSizeBytes()` Get the total number of bytes in the array.
`java.lang.Object`	`getStorage()` Get underlying primitive array storage.
`StructureData`	`getStructureData(Index i)` Get the index-th StructureData of this ArrayStructure.
`StructureData`	`getStructureData(int index)` Get the index-th StructureData of this ArrayStructure.
`StructureDataIterator`	`getStructureDataIterator()`
`java.util.List<java.lang.String>`	`getStructureMemberNames()` Get a list structure member names.
`StructureMembers`	`getStructureMembers()` Get the StructureMembers object.
`int`	`getStructureSize()` Get the size of each StructureData object in bytes.
`protected abstract StructureData`	`makeStructureData(ArrayStructure as, int recno)`
`Array`	`sectionNoReduce(java.util.List<Range> ranges)` Create a new Array as a subsection of this Array, without rank reduction.
`void`	`setBoolean(Index i, boolean value)` DO NOT USE, throw ForbiddenConversionException
`void`	`setBoolean(int index, boolean value)`
`void`	`setByte(Index i, byte value)` DO NOT USE, throw ForbiddenConversionException
`void`	`setByte(int index, byte value)`
`void`	`setChar(Index i, char value)` DO NOT USE, throw ForbiddenConversionException
`void`	`setChar(int index, char value)`
`void`	`setDouble(Index i, double value)` DO NOT USE, throw ForbiddenConversionException
`void`	`setDouble(int index, double value)`
`void`	`setFloat(Index i, float value)` DO NOT USE, throw ForbiddenConversionException
`void`	`setFloat(int index, float value)`
`void`	`setInt(Index i, int value)` DO NOT USE, throw ForbiddenConversionException
`void`	`setInt(int index, int value)`
`void`	`setLong(Index i, long value)` DO NOT USE, throw ForbiddenConversionException
`void`	`setLong(int index, long value)`
`void`	`setMemberArray(StructureMembers.Member m, Array memberArray)` Set data for one member, over all structures.
`void`	`setObject(Index i, java.lang.Object value)` Set one of the StructureData of this ArrayStructure.
`void`	`setObject(int index, java.lang.Object value)` Set the index-th StructureData of this ArrayStructure.
`void`	`setShort(Index i, short value)` DO NOT USE, throw ForbiddenConversionException
`void`	`setShort(int index, short value)`
`void`	`showInternal(java.util.Formatter f, Indent indent)`
`void`	`showInternalMembers(java.util.Formatter f, Indent indent)`

Methods inherited from class ucar.ma2.Array
arraycopy, copyTo1DJavaArray, copyToNDJavaArray, factory, factory, factory, factory, factory, factory, factoryConstant, flip, get1DJavaArray, getDataAsByteBuffer, getDataAsByteBuffer, getDataAsByteBuffer, getDataType, getIndex, getIndexIterator, getIndexIteratorFast, getIndexPrivate, getRangeIterator, getRank, getShape, getSize, hasNext, isConstant, isUnsigned, makeArray, makeArray, makeArray, makeArray, makeArrayRankPlusOne, next, nextBoolean, nextByte, nextChar, nextDouble, nextFloat, nextInt, nextLong, nextShort, permute, reduce, reduce, resetLocalIterator, reshape, reshapeNoCopy, section, section, section, sectionNoReduce, setUnsigned, shapeToString, slice, toString, transpose

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

- Field Detail
  - members
```
protected StructureMembers members
```
  - nelems
```
protected int nelems
```
  - sdata
```
protected StructureData[] sdata
```
- Constructor Detail
  - ArrayStructure
```
protected ArrayStructure(StructureMembers members,
                         int[] shape)
```
    Create a new Array of type StructureData and the given members and shape. dimensions.length determines the rank of the new Array.
    
    Parameters:
    
    members - a description of the structure members
    
    shape - the shape of the Array.
  - ArrayStructure
```
protected ArrayStructure(StructureMembers members,
                         Index ima)
```
- Method Detail
  - copyFrom1DJavaArray
```
protected void copyFrom1DJavaArray(IndexIterator iter,
                                   java.lang.Object javaArray)
```
    Specified by:
    
    copyFrom1DJavaArray in class Array
  - copyTo1DJavaArray
```
protected void copyTo1DJavaArray(IndexIterator iter,
                                 java.lang.Object javaArray)
```
    Specified by:
    
    copyTo1DJavaArray in class Array
  - getElementType
```
public java.lang.Class getElementType()
```
    Description copied from class: Array
    
    Get the element class type of this Array
    
    Specified by:
    
    getElementType in class Array
    
    Returns:
    
    the class of the element
  - getStructureMembers
```
public StructureMembers getStructureMembers()
```
    Get the StructureMembers object.
    
    Returns:
    
    the StructureMembers object.
  - getMembers
```
public java.util.List<StructureMembers.Member> getMembers()
```
    Get a list of structure members.
    
    Returns:
    
    the structure members.
  - getStructureMemberNames
```
public java.util.List<java.lang.String> getStructureMemberNames()
```
    Get a list structure member names.
    
    Returns:
    
    the structure members.
  - findMember
```
public StructureMembers.Member findMember(java.lang.String memberName)
```
    Find a member by its name.
    
    Parameters:
    
    memberName - find member with this name
    
    Returns:
    
    StructureMembers.Member matching the name, or null if not found
  - getSizeBytes
```
public long getSizeBytes()
```
    Description copied from class: Array
    
    Get the total number of bytes in the array.
    
    Overrides:
    
    getSizeBytes in class Array
    
    Returns:
    
    total number of bytes in the array
  - getObject
```
public java.lang.Object getObject(Index i)
```
    Get the index-th StructureData of this ArrayStructure.
    
    Specified by:
    
    getObject in class Array
    
    Parameters:
    
    i - which one to get, specified by an Index.
    
    Returns:
    
    object of type StructureData.
  - setObject
```
public void setObject(Index i,
                      java.lang.Object value)
```
    Set one of the StructureData of this ArrayStructure.
    
    Specified by:
    
    setObject in class Array
    
    Parameters:
    
    i - which one to set, specified by an Index.
    
    value - must be type StructureData.
  - getObject
```
public java.lang.Object getObject(int index)
```
    Get the index-th StructureData of this ArrayStructure.
    
    Specified by:
    
    getObject in class Array
    
    Parameters:
    
    index - which one to get, specified by an integer.
    
    Returns:
    
    object of type StructureData.
  - setObject
```
public void setObject(int index,
                      java.lang.Object value)
```
    Set the index-th StructureData of this ArrayStructure.
    
    Specified by:
    
    setObject in class Array
    
    Parameters:
    
    index - which one to set.
    
    value - must be type StructureData.
  - getStructureData
```
public StructureData getStructureData(Index i)
```
    Get the index-th StructureData of this ArrayStructure.
    
    Parameters:
    
    i - which one to get, specified by an Index.
    
    Returns:
    
    object of type StructureData.
  - getStructureData
```
public StructureData getStructureData(int index)
```
    Get the index-th StructureData of this ArrayStructure.
    
    Parameters:
    
    index - which one to get, specified by an integer.
    
    Returns:
    
    object of type StructureData.
  - getStorage
```
public java.lang.Object getStorage()
```
    Description copied from class: Array
    
    Get underlying primitive array storage. Exposed for efficiency, use at your own risk.
    
    Specified by:
    
    getStorage in class Array
    
    Returns:
    
    underlying primitive array storage
  - makeStructureData
```
protected abstract StructureData makeStructureData(ArrayStructure as,
                                                   int recno)
```
  - getStructureSize
```
public int getStructureSize()
```
    Get the size of each StructureData object in bytes.
    
    Returns:
    
    the size of each StructureData object in bytes.
  - getStructureDataIterator
```
public StructureDataIterator getStructureDataIterator()
```
  - getArray
```
public Array getArray(int recno,
                      StructureMembers.Member m)
```
    Get member data of any type for a specific record as an Array. This may avoid the overhead of creating the StructureData object, but is equivilent to getStructure(recno).getArray( Member m).
    
    Parameters:
    
    recno - get data from the recnum-th StructureData of the ArrayStructure. Must be less than getSize();
    
    m - get data from this StructureMembers.Member.
    
    Returns:
    
    Array values.
  - setMemberArray
```
public void setMemberArray(StructureMembers.Member m,
                           Array memberArray)
```
    Set data for one member, over all structures. This is used by VariableDS to do scale/offset.
    
    Parameters:
    
    m - set data for this StructureMembers.Member.
    
    memberArray - Array values.
  - extractMemberArray
```
public Array extractMemberArray(StructureMembers.Member m)
                         throws java.io.IOException
```
    Extract data for one member, over all structures.
    
    Parameters:
    
    m - get data from this StructureMembers.Member.
    
    Returns:
    
    Array values.
    
    Throws:
    
    java.io.IOException - on read error (only happens for Sequences, otherwise data is already read)
  - copyChars
```
protected void copyChars(int recnum,
                         StructureMembers.Member m,
                         IndexIterator result)
```
  - copyDoubles
```
protected void copyDoubles(int recnum,
                           StructureMembers.Member m,
                           IndexIterator result)
```
  - copyFloats
```
protected void copyFloats(int recnum,
                          StructureMembers.Member m,
                          IndexIterator result)
```
  - copyBytes
```
protected void copyBytes(int recnum,
                         StructureMembers.Member m,
                         IndexIterator result)
```
  - copyShorts
```
protected void copyShorts(int recnum,
                          StructureMembers.Member m,
                          IndexIterator result)
```
  - copyInts
```
protected void copyInts(int recnum,
                        StructureMembers.Member m,
                        IndexIterator result)
```
  - copyLongs
```
protected void copyLongs(int recnum,
                         StructureMembers.Member m,
                         IndexIterator result)
```
  - copyObjects
```
protected void copyObjects(int recnum,
                           StructureMembers.Member m,
                           IndexIterator result)
```
  - copyStructures
```
protected void copyStructures(int recnum,
                              StructureMembers.Member m,
                              IndexIterator result)
```
  - copySequences
```
protected void copySequences(int recnum,
                             StructureMembers.Member m,
                             IndexIterator result)
```
  - getScalarObject
```
public java.lang.Object getScalarObject(int recno,
                                        StructureMembers.Member m)
```
    Get member data array of any type as an Object, eg, Float, Double, String, StructureData etc.
    
    Parameters:
    
    recno - get data from the recnum-th StructureData of the ArrayStructure. Must be less than getSize();
    
    m - get data from this StructureMembers.Member.
    
    Returns:
    
    value as Float, Double, etc..
  - convertScalarFloat
```
public float convertScalarFloat(int recnum,
                                StructureMembers.Member m)
```
    Get scalar value as a float, with conversion as needed. Underlying type must be convertible to float.
    
    Parameters:
    
    recnum - get data from the recnum-th StructureData of the ArrayStructure. Must be less than getSize();
    
    m - member Variable.
    
    Returns:
    
    scalar float value
    
    Throws:
    
    ForbiddenConversionException - if not convertible to float.
  - convertScalarDouble
```
public double convertScalarDouble(int recnum,
                                  StructureMembers.Member m)
```
    Get scalar value as a double, with conversion as needed. Underlying type must be convertible to double.
    
    Parameters:
    
    recnum - get data from the recnum-th StructureData of the ArrayStructure. Must be less than getSize();
    
    m - member Variable.
    
    Returns:
    
    scalar double value
    
    Throws:
    
    ForbiddenConversionException - if not convertible to double.
  - convertScalarInt
```
public int convertScalarInt(int recnum,
                            StructureMembers.Member m)
```
    Get scalar value as an int, with conversion as needed. Underlying type must be convertible to int.
    
    Parameters:
    
    recnum - get data from the recnum-th StructureData of the ArrayStructure. Must be less than getSize();
    
    m - member Variable.
    
    Returns:
    
    scalar double value
    
    Throws:
    
    ForbiddenConversionException - if not convertible to double.
  - convertScalarLong
```
public long convertScalarLong(int recnum,
                              StructureMembers.Member m)
```
  - getScalarDouble
```
public double getScalarDouble(int recnum,
                              StructureMembers.Member m)
```
    Get scalar member data of type double.
    
    Parameters:
    
    recnum - get data from the recnum-th StructureData of the ArrayStructure. Must be less than getSize();
    
    m - get data from this StructureMembers.Member. Must be of type double.
    
    Returns:
    
    scalar double value
  - getJavaArrayDouble
```
public double[] getJavaArrayDouble(int recnum,
                                   StructureMembers.Member m)
```
    Get member data of type double as a 1D array. The member data may be any rank.
    
    Parameters:
    
    recnum - get data from the recnum-th StructureData of the ArrayStructure. Must be less than getSize();
    
    m - get data from this StructureMembers.Member. Must be of type double.
    
    Returns:
    
    double[]
  - getScalarFloat
```
public float getScalarFloat(int recnum,
                            StructureMembers.Member m)
```
    Get scalar member data of type float.
    
    Parameters:
    
    recnum - get data from the recnum-th StructureData of the ArrayStructure. Must be less than getSize();
    
    m - get data from this StructureMembers.Member. Must be of type float.
    
    Returns:
    
    scalar double value
  - getJavaArrayFloat
```
public float[] getJavaArrayFloat(int recnum,
                                 StructureMembers.Member m)
```
    Get member data of type float as a 1D array.
    
    Parameters:
    
    recnum - get data from the recnum-th StructureData of the ArrayStructure. Must be less than getSize();
    
    m - get data from this StructureMembers.Member. Must be of type float.
    
    Returns:
    
    float[]
  - getScalarByte
```
public byte getScalarByte(int recnum,
                          StructureMembers.Member m)
```
    Get scalar member data of type byte.
    
    Parameters:
    
    recnum - get data from the recnum-th StructureData of the ArrayStructure. Must be less than getSize();
    
    m - get data from this StructureMembers.Member. Must be of type byte.
    
    Returns:
    
    scalar double value
  - getJavaArrayByte
```
public byte[] getJavaArrayByte(int recnum,
                               StructureMembers.Member m)
```
    Get member data of type byte as a 1D array.
    
    Parameters:
    
    recnum - get data from the recnum-th StructureData of the ArrayStructure. Must be less than getSize();
    
    m - get data from this StructureMembers.Member. Must be of type byte.
    
    Returns:
    
    byte[]
  - getScalarShort
```
public short getScalarShort(int recnum,
                            StructureMembers.Member m)
```
    Get scalar member data of type short.
    
    Parameters:
    
    recnum - get data from the recnum-th StructureData of the ArrayStructure. Must be less than getSize();
    
    m - get data from this StructureMembers.Member. Must be of type short.
    
    Returns:
    
    scalar double value
  - getJavaArrayShort
```
public short[] getJavaArrayShort(int recnum,
                                 StructureMembers.Member m)
```
    Get member data of type short as a 1D array.
    
    Parameters:
    
    recnum - get data from the recnum-th StructureData of the ArrayStructure. Must be less than getSize();
    
    m - get data from this StructureMembers.Member. Must be of type float.
    
    Returns:
    
    short[]
  - getScalarInt
```
public int getScalarInt(int recnum,
                        StructureMembers.Member m)
```
    Get scalar member data of type int.
    
    Parameters:
    
    recnum - get data from the recnum-th StructureData of the ArrayStructure. Must be less than getSize();
    
    m - get data from this StructureMembers.Member. Must be of type int.
    
    Returns:
    
    scalar double value
  - getJavaArrayInt
```
public int[] getJavaArrayInt(int recnum,
                             StructureMembers.Member m)
```
    Get member data of type int as a 1D array.
    
    Parameters:
    
    recnum - get data from the recnum-th StructureData of the ArrayStructure. Must be less than getSize();
    
    m - get data from this StructureMembers.Member. Must be of type int.
    
    Returns:
    
    int[]
  - getScalarLong
```
public long getScalarLong(int recnum,
                          StructureMembers.Member m)
```
    Get scalar member data of type long.
    
    Parameters:
    
    recnum - get data from the recnum-th StructureData of the ArrayStructure. Must be less than getSize();
    
    m - get data from this StructureMembers.Member. Must be of type long.
    
    Returns:
    
    scalar double value
  - getJavaArrayLong
```
public long[] getJavaArrayLong(int recnum,
                               StructureMembers.Member m)
```
    Get member data of type long as a 1D array.
    
    Parameters:
    
    recnum - get data from the recnum-th StructureData of the ArrayStructure. Must be less than getSize();
    
    m - get data from this StructureMembers.Member. Must be of type long.
    
    Returns:
    
    long[]
  - getScalarChar
```
public char getScalarChar(int recnum,
                          StructureMembers.Member m)
```
    Get scalar member data of type char.
    
    Parameters:
    
    recnum - get data from the recnum-th StructureData of the ArrayStructure. Must be less than getSize();
    
    m - get data from this StructureMembers.Member. Must be of type char.
    
    Returns:
    
    scalar double value
  - getJavaArrayChar
```
public char[] getJavaArrayChar(int recnum,
                               StructureMembers.Member m)
```
    Get member data of type char as a 1D array.
    
    Parameters:
    
    recnum - get data from the recnum-th StructureData of the ArrayStructure. Must be less than getSize();
    
    m - get data from this StructureMembers.Member. Must be of type char.
    
    Returns:
    
    char[]
  - getScalarString
```
public java.lang.String getScalarString(int recnum,
                                        StructureMembers.Member m)
```
    Get member data of type String or char.
    
    Parameters:
    
    recnum - get data from the recnum-th StructureData of the ArrayStructure. Must be less than getSize();
    
    m - get data from this StructureMembers.Member. Must be of type String or char.
    
    Returns:
    
    scalar String value
  - getJavaArrayString
```
public java.lang.String[] getJavaArrayString(int recnum,
                                             StructureMembers.Member m)
```
    Get member data of type String as a 1D array.
    
    Parameters:
    
    recnum - get data from the recnum-th StructureData of the ArrayStructure. Must be less than getSize();
    
    m - get data from this StructureMembers.Member. Must be of type String.
    
    Returns:
    
    String[]
  - getScalarStructure
```
public StructureData getScalarStructure(int recnum,
                                        StructureMembers.Member m)
```
    Get member data of type Structure.
    
    Parameters:
    
    recnum - get data from the recnum-th StructureData of the ArrayStructure. Must be less than getSize();
    
    m - get data from this StructureMembers.Member. Must be of type Structure.
    
    Returns:
    
    scalar StructureData
  - getArrayStructure
```
public ArrayStructure getArrayStructure(int recnum,
                                        StructureMembers.Member m)
```
    Get member data of type array of Structure.
    
    Parameters:
    
    recnum - get data from the recnum-th StructureData of the ArrayStructure. Must be less than getSize();
    
    m - get data from this StructureMembers.Member. Must be of type Structure.
    
    Returns:
    
    nested ArrayStructure.
  - getArraySequence
```
public ArraySequence getArraySequence(int recnum,
                                      StructureMembers.Member m)
```
    Get member data of type ArraySequence
    
    Parameters:
    
    recnum - get data from the recnum-th StructureData of the ArrayStructure. Must be less than getSize();
    
    m - get data from this StructureMembers.Member. Must be of type Structure.
    
    Returns:
    
    nested ArrayStructure.
  - getArrayObject
```
public ArrayObject getArrayObject(int recnum,
                                  StructureMembers.Member m)
```
    Get member data of type ArrayObject
    
    Parameters:
    
    recnum - get data from the recnum-th StructureData of the ArrayStructure. Must be less than getSize();
    
    m - get data from this StructureMembers.Member. Must be of type Structure.
    
    Returns:
    
    ArrayObject.
  - showInternal
```
public void showInternal(java.util.Formatter f,
                         Indent indent)
```
  - showInternalMembers
```
public void showInternalMembers(java.util.Formatter f,
                                Indent indent)
```
  - createView
```
public Array createView(Index index)
```
    Description copied from class: Array
    
    create new Array with given Index and the same backing store
    
    Specified by:
    
    createView in class Array
    
    Parameters:
    
    index - use this Index
    
    Returns:
    
    a view of the Array using the given Index
  - sectionNoReduce
```
public Array sectionNoReduce(java.util.List<Range> ranges)
                      throws InvalidRangeException
```
    Description copied from class: Array
    
    Create a new Array as a subsection of this Array, without rank reduction. No data is moved, so the new Array references the same backing store as the original. Vlen is transferred over unchanged.
    
    Overrides:
    
    sectionNoReduce in class Array
    
    Parameters:
    
    ranges - list of Ranges that specify the array subset. Must be same rank as original Array. A particular Range: 1) may be a subset, or 2) may be null, meaning use entire Range.
    
    Returns:
    
    the new Array
    
    Throws:
    
    InvalidRangeException - if ranges is invalid
  - copy
```
public Array copy()
```
    DO NOT USE, throws UnsupportedOperationException
    
    Overrides:
    
    copy in class Array
    
    Returns:
    
    the new Array
  - getDouble
```
public double getDouble(Index i)
```
    DO NOT USE, throw ForbiddenConversionException
    
    Specified by:
    
    getDouble in class Array
    
    Parameters:
    
    i - Index with current element set
    
    Returns:
    
    value at index cast to double if necessary.
  - setDouble
```
public void setDouble(Index i,
                      double value)
```
    DO NOT USE, throw ForbiddenConversionException
    
    Specified by:
    
    setDouble in class Array
    
    Parameters:
    
    i - Index with current element set
    
    value - the new value; cast to underlying data type if necessary.
  - getFloat
```
public float getFloat(Index i)
```
    DO NOT USE, throw ForbiddenConversionException
    
    Specified by:
    
    getFloat in class Array
    
    Parameters:
    
    i - Index with current element set
    
    Returns:
    
    value at index cast to float if necessary.
  - setFloat
```
public void setFloat(Index i,
                     float value)
```
    DO NOT USE, throw ForbiddenConversionException
    
    Specified by:
    
    setFloat in class Array
    
    Parameters:
    
    i - Index with current element set
    
    value - the new value; cast to underlying data type if necessary.
  - getLong
```
public long getLong(Index i)
```
    DO NOT USE, throw ForbiddenConversionException
    
    Specified by:
    
    getLong in class Array
    
    Parameters:
    
    i - Index with current element set
    
    Returns:
    
    value at index cast to long if necessary.
  - setLong
```
public void setLong(Index i,
                    long value)
```
    DO NOT USE, throw ForbiddenConversionException
    
    Specified by:
    
    setLong in class Array
    
    Parameters:
    
    i - Index with current element set
    
    value - the new value; cast to underlying data type if necessary.
  - getInt
```
public int getInt(Index i)
```
    DO NOT USE, throw ForbiddenConversionException
    
    Specified by:
    
    getInt in class Array
    
    Parameters:
    
    i - Index with current element set
    
    Returns:
    
    value at index cast to int if necessary.
  - setInt
```
public void setInt(Index i,
                   int value)
```
    DO NOT USE, throw ForbiddenConversionException
    
    Specified by:
    
    setInt in class Array
    
    Parameters:
    
    i - Index with current element set
    
    value - the new value; cast to underlying data type if necessary.
  - getShort
```
public short getShort(Index i)
```
    DO NOT USE, throw ForbiddenConversionException
    
    Specified by:
    
    getShort in class Array
    
    Parameters:
    
    i - Index with current element set
    
    Returns:
    
    value at index cast to short if necessary.
  - setShort
```
public void setShort(Index i,
                     short value)
```
    DO NOT USE, throw ForbiddenConversionException
    
    Specified by:
    
    setShort in class Array
    
    Parameters:
    
    i - Index with current element set
    
    value - the new value; cast to underlying data type if necessary.
  - getByte
```
public byte getByte(Index i)
```
    DO NOT USE, throw ForbiddenConversionException
    
    Specified by:
    
    getByte in class Array
    
    Parameters:
    
    i - Index with current element set
    
    Returns:
    
    value at index cast to float if necessary.
  - setByte
```
public void setByte(Index i,
                    byte value)
```
    DO NOT USE, throw ForbiddenConversionException
    
    Specified by:
    
    setByte in class Array
    
    Parameters:
    
    i - Index with current element set
    
    value - the new value; cast to underlying data type if necessary.
  - getBoolean
```
public boolean getBoolean(Index i)
```
    DO NOT USE, throw ForbiddenConversionException
    
    Specified by:
    
    getBoolean in class Array
    
    Parameters:
    
    i - Index with current element set
    
    Returns:
    
    value at index cast to boolean if necessary.
  - setBoolean
```
public void setBoolean(Index i,
                       boolean value)
```
    DO NOT USE, throw ForbiddenConversionException
    
    Specified by:
    
    setBoolean in class Array
    
    Parameters:
    
    i - Index with current element set
    
    value - the new value; cast to underlying data type if necessary.
  - getChar
```
public char getChar(Index i)
```
    DO NOT USE, throw ForbiddenConversionException
    
    Specified by:
    
    getChar in class Array
    
    Parameters:
    
    i - Index with current element set
    
    Returns:
    
    value at index cast to char if necessary.
  - setChar
```
public void setChar(Index i,
                    char value)
```
    DO NOT USE, throw ForbiddenConversionException
    
    Specified by:
    
    setChar in class Array
    
    Parameters:
    
    i - Index with current element set
    
    value - the new value; cast to underlying data type if necessary.
  - getDouble
```
public double getDouble(int index)
```
    Specified by:
    
    getDouble in class Array
  - setDouble
```
public void setDouble(int index,
                      double value)
```
    Specified by:
    
    setDouble in class Array
  - getFloat
```
public float getFloat(int index)
```
    Specified by:
    
    getFloat in class Array
  - setFloat
```
public void setFloat(int index,
                     float value)
```
    Specified by:
    
    setFloat in class Array
  - getLong
```
public long getLong(int index)
```
    Specified by:
    
    getLong in class Array
  - setLong
```
public void setLong(int index,
                    long value)
```
    Specified by:
    
    setLong in class Array
  - getInt
```
public int getInt(int index)
```
    Specified by:
    
    getInt in class Array
  - setInt
```
public void setInt(int index,
                   int value)
```
    Specified by:
    
    setInt in class Array
  - getShort
```
public short getShort(int index)
```
    Specified by:
    
    getShort in class Array
  - setShort
```
public void setShort(int index,
                     short value)
```
    Specified by:
    
    setShort in class Array
  - getByte
```
public byte getByte(int index)
```
    Specified by:
    
    getByte in class Array
  - setByte
```
public void setByte(int index,
                    byte value)
```
    Specified by:
    
    setByte in class Array
  - getChar
```
public char getChar(int index)
```
    Specified by:
    
    getChar in class Array
  - setChar
```
public void setChar(int index,
                    char value)
```
    Specified by:
    
    setChar in class Array
  - getBoolean
```
public boolean getBoolean(int index)
```
    Specified by:
    
    getBoolean in class Array
  - setBoolean
```
public void setBoolean(int index,
                       boolean value)
```
    Specified by:
    
    setBoolean in class Array

Class ArrayStructure

Nested Class Summary

Field Summary

Fields inherited from class ucar.ma2.Array

Constructor Summary

Method Summary

Methods inherited from class ucar.ma2.Array

Methods inherited from class java.lang.Object

Field Detail

members

nelems

sdata

Constructor Detail

ArrayStructure

ArrayStructure

Method Detail

copyFrom1DJavaArray

copyTo1DJavaArray

getElementType

getStructureMembers

getMembers

getStructureMemberNames

findMember

getSizeBytes

getObject

setObject

getObject

setObject

getStructureData

getStructureData

getStorage

makeStructureData

getStructureSize

getStructureDataIterator

getArray

setMemberArray

extractMemberArray

copyChars

copyDoubles

copyFloats

copyBytes

copyShorts

copyInts

copyLongs

copyObjects

copyStructures

copySequences

getScalarObject

convertScalarFloat

convertScalarDouble

convertScalarInt

convertScalarLong

getScalarDouble

getJavaArrayDouble

getScalarFloat

getJavaArrayFloat

getScalarByte

getJavaArrayByte

getScalarShort

getJavaArrayShort

getScalarInt

getJavaArrayInt

getScalarLong

getJavaArrayLong

getScalarChar

getJavaArrayChar

getScalarString

getJavaArrayString

getScalarStructure

getArrayStructure

getArraySequence

getArrayObject

showInternal

showInternalMembers

createView

sectionNoReduce

copy

getDouble

setDouble

getFloat