| /* |
| * 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.lucene.analysis.tokenattributes; |
| |
| |
| import org.apache.lucene.util.Attribute; |
| |
| /** |
| * The term text of a Token. |
| */ |
| public interface CharTermAttribute extends Attribute, CharSequence, Appendable { |
| |
| /** Copies the contents of buffer, starting at offset for |
| * length characters, into the termBuffer array. |
| * @param buffer the buffer to copy |
| * @param offset the index in the buffer of the first character to copy |
| * @param length the number of characters to copy |
| */ |
| public void copyBuffer(char[] buffer, int offset, int length); |
| |
| /** Returns the internal termBuffer character array which |
| * you can then directly alter. If the array is too |
| * small for your token, use {@link |
| * #resizeBuffer(int)} to increase it. After |
| * altering the buffer be sure to call {@link |
| * #setLength} to record the number of valid |
| * characters that were placed into the termBuffer. |
| * <p> |
| * <b>NOTE</b>: The returned buffer may be larger than |
| * the valid {@link #length()}. |
| */ |
| public char[] buffer(); |
| |
| /** Grows the termBuffer to at least size newSize, preserving the |
| * existing content. |
| * @param newSize minimum size of the new termBuffer |
| * @return newly created termBuffer with {@code length >= newSize} |
| */ |
| public char[] resizeBuffer(int newSize); |
| |
| /** Set number of valid characters (length of the term) in |
| * the termBuffer array. Use this to truncate the termBuffer |
| * or to synchronize with external manipulation of the termBuffer. |
| * Note: to grow the size of the array, |
| * use {@link #resizeBuffer(int)} first. |
| * @param length the truncated length |
| */ |
| public CharTermAttribute setLength(int length); |
| |
| /** Sets the length of the termBuffer to zero. |
| * Use this method before appending contents |
| * using the {@link Appendable} interface. |
| */ |
| public CharTermAttribute setEmpty(); |
| |
| // the following methods are redefined to get rid of IOException declaration: |
| @Override |
| public CharTermAttribute append(CharSequence csq); |
| @Override |
| public CharTermAttribute append(CharSequence csq, int start, int end); |
| @Override |
| public CharTermAttribute append(char c); |
| |
| /** Appends the specified {@code String} to this character sequence. |
| * <p>The characters of the {@code String} argument are appended, in order, increasing the length of |
| * this sequence by the length of the argument. If argument is {@code null}, then the four |
| * characters {@code "null"} are appended. |
| */ |
| public CharTermAttribute append(String s); |
| |
| /** Appends the specified {@code StringBuilder} to this character sequence. |
| * <p>The characters of the {@code StringBuilder} argument are appended, in order, increasing the length of |
| * this sequence by the length of the argument. If argument is {@code null}, then the four |
| * characters {@code "null"} are appended. |
| */ |
| public CharTermAttribute append(StringBuilder sb); |
| |
| /** Appends the contents of the other {@code CharTermAttribute} to this character sequence. |
| * <p>The characters of the {@code CharTermAttribute} argument are appended, in order, increasing the length of |
| * this sequence by the length of the argument. If argument is {@code null}, then the four |
| * characters {@code "null"} are appended. |
| */ |
| public CharTermAttribute append(CharTermAttribute termAtt); |
| } |