| /* |
| * 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; |
| |
| /** |
| * String array interface. To create a string array object, use |
| * {@link org.apache.uima.cas.CAS#createStringArrayFS CAS.createStringArrayFS()}. |
| * |
| * |
| */ |
| public interface StringArrayFS extends CommonArrayFS { |
| |
| /** |
| * Get the i-th string from the array. |
| * @param i the index |
| * @return The i-th element. |
| * @exception ArrayIndexOutOfBoundsException |
| * If the index is out of bounds. |
| */ |
| String get(int i) throws ArrayIndexOutOfBoundsException; |
| |
| /** |
| * Set the i-th value. |
| * |
| * @param i |
| * The index. |
| * @param str |
| * The value. |
| * @exception ArrayIndexOutOfBoundsException |
| * If <code>i</code> is out of bounds. |
| */ |
| void set(int i, String str) throws ArrayIndexOutOfBoundsException; |
| |
| // these next 2 are inherited from super interface |
| // /** |
| // * 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, String[] 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(String[] 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. |
| */ |
| String[] toArray(); |
| } |