ucar.ma2

Class Section.Builder

java.lang.Object

ucar.ma2.Section.Builder

Enclosing class:

Section

public static class Section.Builder
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
Section.Builder	appendRange(int size) Append a new Range(0,size-1)
Section.Builder	appendRange(int first, int last) Append a new Range(first, last) to the Section
Section.Builder	appendRange(int first, int last, int stride) Append a new Range(first,last,stride) to the Section.
Section.Builder	appendRange(Range range) Append a Range to the Section
Section.Builder	appendRange(java.lang.String name, int first, int last, int stride) Append a new Range(name,first,last,stride) to the Section
Section.Builder	appendRangeAll() Append a Range to the Section meaning "all"
Section.Builder	appendRanges(int[] shape) Create Section from a shape array, assumes 0 origin.
Section.Builder	appendRanges(java.util.List<Range> ranges) Append Ranges to the Section
Section	build()
Section.Builder	insertRange(int index, Range r) Insert a range at the specified index in the list.
Section.Builder	removeFirst(int n) Remove the first n Ranges, n <= number of ranges.
Section.Builder	removeLast() Remove the last range, if it exists.
Section.Builder	removeRange(int index) Remove a range at the specified index in the list.
Section.Builder	removeVlen() Remove the last range, if it exists and is a Vlen.
Section.Builder	replaceRange(int index, Range r) Replace a range at the specified index in the list.
Section.Builder	setRange(int index, Range r) Set the range at the specified index in the list, previous Range is discarded

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Builder

public Builder()

Method Detail

appendRange

public Section.Builder appendRange(int size)

Append a new Range(0,size-1)

appendRange

public Section.Builder appendRange(int first,
                                   int last)
                            throws InvalidRangeException

Append a new Range(first, last) to the Section

Parameters:

first - starting index

last - last index, inclusive. If last < 0, then append a VLEN Range.

Throws:

InvalidRangeException

appendRange

public Section.Builder appendRange(int first,
                                   int last,
                                   int stride)
                            throws InvalidRangeException

Append a new Range(first,last,stride) to the Section.

Parameters:

first - starting index

last - last index, inclusive

stride - stride

Throws:

InvalidRangeException

appendRange

public Section.Builder appendRange(Range range)

Append a Range to the Section

Parameters:

range - not null.

appendRange

public Section.Builder appendRange(java.lang.String name,
                                   int first,
                                   int last,
                                   int stride)
                            throws InvalidRangeException

Append a new Range(name,first,last,stride) to the Section

Parameters:

name - name of Range

first - starting index

last - last index, inclusive

stride - stride

Throws:

InvalidRangeException

appendRangeAll

public Section.Builder appendRangeAll()

Append a Range to the Section meaning "all"

appendRanges

public Section.Builder appendRanges(int[] shape)

Create Section from a shape array, assumes 0 origin.

Parameters:

shape - array of lengths for each Range. 0 = EMPTY, < 0 = VLEN

appendRanges

public Section.Builder appendRanges(java.util.List<Range> ranges)

Append Ranges to the Section

Parameters:

ranges - not null.

build

public Section build()

insertRange

public Section.Builder insertRange(int index,
                                   Range r)

Insert a range at the specified index in the list.

Parameters:

index - insert here in the list, existing ranges at or after this index get shifted by one

r - insert this Range

removeFirst

public Section.Builder removeFirst(int n)

Remove the first n Ranges, n <= number of ranges.

removeLast

public Section.Builder removeLast()

Remove the last range, if it exists.

removeRange

public Section.Builder removeRange(int index)

Remove a range at the specified index in the list.

Parameters:

index - remove here in the list, existing ranges after this index get shifted by one

removeVlen

public Section.Builder removeVlen()

Remove the last range, if it exists and is a Vlen.

replaceRange

public Section.Builder replaceRange(int index,
                                    Range r)

Replace a range at the specified index in the list.

Parameters:

index - replace here in the list.

r - use this Range

Returns:

this

Throws:

java.lang.IndexOutOfBoundsException - if bad index

setRange

public Section.Builder setRange(int index,
                                Range r)

Set the range at the specified index in the list, previous Range is discarded

Parameters:

index - list index, must be in interval [0,size).

r - insert this Range