| /* |
| * Licensed to the Apache Software Foundation (ASF) under one |
| * or more contributor license agreements. See the NOTICE file |
| * distributed with this work for additional information |
| * regarding copyright ownership. The ASF licenses this file |
| * to you under the Apache License, Version 2.0 (the |
| * "License"); you may not use this file except in compliance |
| * with the License. You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, |
| * software distributed under the License is distributed on an |
| * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| * KIND, either express or implied. See the License for the |
| * specific language governing permissions and limitations |
| * under the License. |
| */ |
| |
| package org.apache.uima.cas; |
| |
| /** |
| * Long array interface. To create a long array object, use |
| * {@link org.apache.uima.cas.CAS#createLongArrayFS CAS.createLongArrayFS()}. |
| * |
| * |
| */ |
| public interface LongArrayFS extends CommonArrayFS { |
| |
| /** |
| * Get the i-th element from the array. |
| * @param i the index |
| * @return The i-th element. |
| * @exception ArrayIndexOutOfBoundsException |
| * If the index is out of bounds. |
| */ |
| long get(int i) throws ArrayIndexOutOfBoundsException; |
| |
| /** |
| * Set the i-th value. |
| * |
| * @param i |
| * The index. |
| * @param b |
| * The value. |
| * @exception ArrayIndexOutOfBoundsException |
| * If <code>i</code> is out of bounds. |
| */ |
| void set(int i, long b) throws ArrayIndexOutOfBoundsException; |
| |
| /** |
| * Copy the contents of the array from <code>start</code> to <code>end</code> to the |
| * destination <code>destArray</code> with destination offset <code>destOffset</code>. |
| * |
| * @param srcOffset |
| * The index of the first element to copy. |
| * @param dest |
| * The array to copy to. |
| * @param destOffset |
| * Where to start copying into <code>dest</code>. |
| * @param length |
| * The number of elements to copy. |
| * @exception ArrayIndexOutOfBoundsException |
| * If <code>srcOffset < 0</code> or <code>length > size()</code> or |
| * <code>destOffset + length > destArray.length</code>. |
| */ |
| void copyToArray(int srcOffset, long[] dest, int destOffset, int length) |
| throws ArrayIndexOutOfBoundsException; |
| |
| /** |
| * Copy the contents of an external array into this array. |
| * |
| * @param src |
| * The source array. |
| * @param srcOffset |
| * Where to start copying in the source array. |
| * @param destOffset |
| * Where to start copying to in the destination array. |
| * @param length |
| * The number of elements to copy. |
| */ |
| void copyFromArray(long[] src, int srcOffset, int destOffset, int length) |
| throws ArrayIndexOutOfBoundsException; |
| /** |
| * Creates a new array the this array is copied to. |
| * |
| * @return A Java array copy of this FS array. |
| */ |
| long[] toArray(); |
| } |