In order to support fields of the same name in subclasses we are now prefixing them with name of the class that defines them. To provide convenient way to access them from generated bytecode and also directly from JavaScript, there is a getter/setter function for each field. It starts with _ followed by the field name. If called with a parameter, it sets the field, with a parameter it just returns it.
2 * Copyright (c) 2000, 2003, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation. Oracle designates this
8 * particular file as subject to the "Classpath" exception as provided
9 * by Oracle in the LICENSE file that accompanied this code.
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 * or visit www.oracle.com if you need additional information or have any
30 * A <tt>CharSequence</tt> is a readable sequence of <code>char</code> values. This
31 * interface provides uniform, read-only access to many different kinds of
32 * <code>char</code> sequences.
33 * A <code>char</code> value represents a character in the <i>Basic
34 * Multilingual Plane (BMP)</i> or a surrogate. Refer to <a
35 * href="Character.html#unicode">Unicode Character Representation</a> for details.
37 * <p> This interface does not refine the general contracts of the {@link
38 * java.lang.Object#equals(java.lang.Object) equals} and {@link
39 * java.lang.Object#hashCode() hashCode} methods. The result of comparing two
40 * objects that implement <tt>CharSequence</tt> is therefore, in general,
41 * undefined. Each object may be implemented by a different class, and there
42 * is no guarantee that each class will be capable of testing its instances
43 * for equality with those of the other. It is therefore inappropriate to use
44 * arbitrary <tt>CharSequence</tt> instances as elements in a set or as keys in
47 * @author Mike McCloskey
52 public interface CharSequence {
55 * Returns the length of this character sequence. The length is the number
56 * of 16-bit <code>char</code>s in the sequence.</p>
58 * @return the number of <code>char</code>s in this sequence
63 * Returns the <code>char</code> value at the specified index. An index ranges from zero
64 * to <tt>length() - 1</tt>. The first <code>char</code> value of the sequence is at
65 * index zero, the next at index one, and so on, as for array
68 * <p>If the <code>char</code> value specified by the index is a
69 * <a href="{@docRoot}/java/lang/Character.html#unicode">surrogate</a>, the surrogate
72 * @param index the index of the <code>char</code> value to be returned
74 * @return the specified <code>char</code> value
76 * @throws IndexOutOfBoundsException
77 * if the <tt>index</tt> argument is negative or not less than
80 char charAt(int index);
83 * Returns a new <code>CharSequence</code> that is a subsequence of this sequence.
84 * The subsequence starts with the <code>char</code> value at the specified index and
85 * ends with the <code>char</code> value at index <tt>end - 1</tt>. The length
86 * (in <code>char</code>s) of the
87 * returned sequence is <tt>end - start</tt>, so if <tt>start == end</tt>
88 * then an empty sequence is returned. </p>
90 * @param start the start index, inclusive
91 * @param end the end index, exclusive
93 * @return the specified subsequence
95 * @throws IndexOutOfBoundsException
96 * if <tt>start</tt> or <tt>end</tt> are negative,
97 * if <tt>end</tt> is greater than <tt>length()</tt>,
98 * or if <tt>start</tt> is greater than <tt>end</tt>
100 CharSequence subSequence(int start, int end);
103 * Returns a string containing the characters in this sequence in the same
104 * order as this sequence. The length of the string will be the length of
105 * this sequence. </p>
107 * @return a string consisting of exactly this sequence of characters
109 public String toString();