Direct Known Subclasses:

MultiSlice
```
public class Slice
extends Object
```
A Slice is used for two purposes
1. To specify a subset of data to extract.
2. To specify a subset of data as specified in a constraint.
In case two, the "last" value of the slice may be undefined (e.q. specifying [0:]) and so they must be filled in at some point. Note that first cannot be undefined because it always defaults to zero; similarly stride defaults to one. Slice Supports iteration. Modifiied 10/15/2016 to support zero sized slices.

Nested Class Summary

Nested Classes
Modifier and Type Class Description

static class Slice.Sort

Field Summary

Fields
Modifier and Type	Field	Description
`protected boolean`	`constrained`	Indicate that this slice's first/last/stride were specifically set; typically from a constraint.
`static long`	`MAXLENGTH`
`static Slice`	`SCALARSLICE`
`static List<Slice>`	`SCALARSLICES`
`protected Slice.Sort`	`sort`
`static long`	`UNDEFINED`

Constructor Summary

Constructors
Constructor	Description
`Slice()`
`Slice(long first, long stop, long stride)`
`Slice(long first, long stop, long stride, long maxsize)`
`Slice(DapDimension dim)`
`Slice(Slice s)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`static Slice`	`compose(Slice target, Slice src)`	Take two slices and compose src wrt target Assume neither argument is null.
`boolean`	`equals(Object o)`	Compare two slices for equality
`Slice`	`finish()`	Perform sanity checks on a slice and repair where possible.
`long`	`getCount()`	Compute the number of elements in the slice.
`long`	`getFirst()`
`long`	`getLast()`
`long`	`getMax()`
`long`	`getSize()`
`Slice.Sort`	`getSort()`
`long`	`getStop()`
`long`	`getStride()`
`Slice`	`getSubSlice(int i)`
`List<Slice>`	`getSubSlices()`
`int`	`hashCode()`
`Boolean`	`isConstrained()`
`Boolean`	`isWhole()`
`SliceIterator`	`iterator()`
`Slice`	`setConstrained(Boolean tf)`
`Slice`	`setIndices(long first, long stop, long stride)`
`Slice`	`setIndices(long first, long stop, long stride, long maxsize)`
`Slice`	`setMaxSize(long size)`
`Slice`	`setWhole(Boolean tf)`
`String`	`toConstraintString()`	Convert this slice to a string suitable for use in a constraint
`String`	`toString()`
`String`	`toString(boolean withbrackets)`

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

Field Detail
- UNDEFINED
```
public static final long UNDEFINED
```
  See Also:
  
  Constant Field Values
- MAXLENGTH
```
public static final long MAXLENGTH
```
  See Also:
  
  Constant Field Values
- SCALARSLICES
```
public static List<Slice> SCALARSLICES
```
- SCALARSLICE
```
public static Slice SCALARSLICE
```
- sort
```
protected Slice.Sort sort
```
- constrained
```
protected boolean constrained
```
  Indicate that this slice's first/last/stride were specifically set; typically from a constraint. Defaults to true.

Constructor Detail

Slice
```
public Slice()
```

Slice

public Slice(long first,
             long stop,
             long stride)
      throws DapException

Throws:: DapException

Slice

public Slice(long first,
             long stop,
             long stride,
             long maxsize)
      throws DapException

Throws:: DapException

Slice

public Slice(Slice s)
      throws DapException

Throws:: DapException

Slice

public Slice(DapDimension dim)
      throws DapException

Throws:: DapException

Method Detail

finish
```
public Slice finish()
             throws DapException
```
Perform sanity checks on a slice and repair where possible.

Returns:

this (fluent interface)

Throws:

DapException - if slice is malformed

iterator
```
public SliceIterator iterator()
```

getSort
```
public Slice.Sort getSort()
```

getFirst
```
public long getFirst()
```

getStop
```
public long getStop()
```

getLast
```
public long getLast()
```

getStride
```
public long getStride()
```

getSize
```
public long getSize()
```

getMax
```
public long getMax()
```

setMaxSize

public Slice setMaxSize(long size)
                 throws DapException

Throws:: DapException

setIndices

public Slice setIndices(long first,
                        long stop,
                        long stride)
                 throws DapException

Throws:: DapException

setIndices

public Slice setIndices(long first,
                        long stop,
                        long stride,
                        long maxsize)
                 throws DapException

Throws:: DapException

isWhole
```
public Boolean isWhole()
```

setWhole
```
public Slice setWhole(Boolean tf)
```

isConstrained
```
public Boolean isConstrained()
```

setConstrained

public Slice setConstrained(Boolean tf)

getCount
```
public long getCount()
```
Compute the number of elements in the slice. Note that this is different from getStop() because stride is taken into account.

equals
```
public boolean equals(Object o)
```
Compare two slices for equality

Overrides:

equals in class Object

Parameters:

o - the other slice to compare with

Returns:

true if this and other are the same, false otherwise

hashCode
```
public int hashCode()
```
Overrides:

hashCode in class Object

toString
```
public String toString()
```
Overrides:

toString in class Object

toString

public String toString(boolean withbrackets)

toConstraintString
```
public String toConstraintString()
                          throws DapException
```
Convert this slice to a string suitable for use in a constraint

Returns:

constraint usable string

Throws:

DapException

compose
```
public static Slice compose(Slice target,
                            Slice src)
                     throws DapException
```
Take two slices and compose src wrt target Assume neither argument is null. This code should match ucar.ma2.Section in thredds and dceconstraint.c in the netcdf-c library.

Parameters:

target -

src -

Returns:

new, composed Range

Throws:

DapException

getSubSlices
```
public List<Slice> getSubSlices()
```

getSubSlice
```
public Slice getSubSlice(int i)
```

Class Slice

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

UNDEFINED

MAXLENGTH

SCALARSLICES

SCALARSLICE

sort

constrained

Constructor Detail

Slice

Slice

Slice

Slice

Slice

Method Detail

finish

iterator

getSort

getFirst

getStop

getLast

getStride

getSize

getMax

setMaxSize

setIndices

setIndices

isWhole

setWhole

isConstrained

setConstrained

getCount

equals

hashCode

toString

toString

toConstraintString

compose

getSubSlices

getSubSlice