CIP JAVA documentation for class "com.ptc.cipjava.intseq"

Class intseq

package com.ptc.cipjava; public class intseq implements jxobject

Description

Sequence of integers.

The user can access elements by their integer index (position) in the list. Sequence provides methods for positional (indexed) access to its elements. Sequences are zero based.

Method Summary
`static intseq`	`create ()` Creates a new empty sequence.
`int`	`get (int idx)` Returns the value of the sequence element with the specified index. If the index is out of range, this method throws exception `cipXInvalidSeqIndex`.
`int`	`getarraysize ()` Returns current number of elements in the sequence.
`void`	`insert (int idx, int value)` Inserts an element with the specified value in front of the sequence element with the specified index. If the index is out of range, the sequence is expanded to include this index.
`void`	`insertseq (int idx, intseq seq)` Inserts elements from the list passed as the second argument in front of the sequence element with the specified index. If the index is out of range, the sequence is expanded to include this index.
`void`	`removerange (int frominc, int toexcl)` Removes elements in the specified range from the sequence. The first argument specifies the index of the first element to be removed. The second argument specifies the index of the element immediately after the last in the range to be removed.
`void`	`set (int idx, int value)` Assigns a value to the sequence element with the specified index. If the index is out of range, the sequence is expanded to include this index.

Method Detail

getarraysize

int getarraysize ()

Returns current number of elements in the sequence.

Returns:: Current number of elements.

get

int get (int idx)

Returns the value of the sequence element with the specified index. If the index is out of range, this method throws exception cipXInvalidSeqIndex.

Parameters:

idx: Index of requested sequence element.

Returns:: Value of the element at the specified index.

set

void set (int idx, int value)

Assigns a value to the sequence element with the specified index. If the index is out of range, the sequence is expanded to include this index.

Parameters:

idx: Index of the element to be assigned.
value: Value to be assigned.

Returns:

removerange

void removerange (int frominc, int toexcl)

Removes elements in the specified range from the sequence. The first argument specifies the index of the first element to be removed. The second argument specifies the index of the element immediately after the last in the range to be removed.

Parameters:

frominc: Index of the first element to be removed.
toexcl: Index of the element following the last element to be removed.

Returns:

insert

void insert (int idx, int value)

Inserts an element with the specified value in front of the sequence element with the specified index. If the index is out of range, the sequence is expanded to include this index.

Parameters:

idx: Index for an element to be inserted at.
value: Value to be inserted.

Returns:

insertseq

void insertseq (int idx, intseq seq)

Inserts elements from the list passed as the second argument in front of the sequence element with the specified index. If the index is out of range, the sequence is expanded to include this index.

Parameters:

idx: Index at which the first new element should be inserted.
seq: Sequence of elements to be inserted.

Returns:

create

static intseq create ()

Creates a new empty sequence.

Returns:: Created sequence.