/*
* 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 java.lang;
import java.io.Serializable;
// BEGIN android-removed
// import java.util.SortedMap;
// import java.util.TreeMap;
//
// import org.apache.harmony.luni.util.BinarySearch;
// END android-removed
// BEGIN android-changed
import com.ibm.icu4jni.lang.UCharacter;
// END android-changed
/**
* The wrapper for the primitive type {@code char}. This class also provides a
* number of utility methods for working with characters.
* <p>
* Character data is based upon the Unicode Standard, 4.0. The Unicode
* specification, character tables and other information are available at <a
* href="http://www.unicode.org/">http://www.unicode.org/</a>.
* </p>
* <p>
* Unicode characters are referred to as <i>code points</i>. The range of valid
* code points is U+0000 to U+10FFFF. The <i>Basic Multilingual Plane (BMP)</i>
* is the code point range U+0000 to U+FFFF. Characters above the BMP are
* referred to as <i>Supplementary Characters</i>. On the Java platform, UTF-16
* encoding and {@code char} pairs are used to represent code points in the
* supplementary range. A pair of {@code char} values that represent a
* supplementary character are made up of a <i>high surrogate</i> with a value
* range of 0xD800 to 0xDBFF and a <i>low surrogate</i> with a value range of
* 0xDC00 to 0xDFFF.
* </p>
* <p>
* On the Java platform a {@code char} value represents either a single BMP code
* point or a UTF-16 unit that's part of a surrogate pair. The {@code int} type
* is used to represent all Unicode code points.
* </p>
*
* @since Android 1.0
*/
public final class Character implements Serializable, Comparable<Character> {
private static final long serialVersionUID = 3786198910865385080L;
private final char value;
/**
* The minimum {@code Character} value.
*
* @since Android 1.0
*/
public static final char MIN_VALUE = '\u0000';
/**
* The maximum {@code Character} value.
*
* @since Android 1.0
*/
public static final char MAX_VALUE = '\uffff';
/**
* The minimum radix used for conversions between characters and integers.
*
* @since Android 1.0
*/
public static final int MIN_RADIX = 2;
/**
* The maximum radix used for conversions between characters and integers.
*
* @since Android 1.0
*/
public static final int MAX_RADIX = 36;
/**
* The {@link Class} object that represents the primitive type {@code char}.
*
* @since Android 1.0
*/
@SuppressWarnings("unchecked")
public static final Class<Character> TYPE = (Class<Character>) new char[0]
.getClass().getComponentType();
// Note: This can't be set to "char.class", since *that* is
// defined to be "java.lang.Character.TYPE";
/**
* Unicode category constant Cn.
*
* @since Android 1.0
*/
public static final byte UNASSIGNED = 0;
/**
* Unicode category constant Lu.
*
* @since Android 1.0
*/
public static final byte UPPERCASE_LETTER = 1;
/**
* Unicode category constant Ll.
*
* @since Android 1.0
*/
public static final byte LOWERCASE_LETTER = 2;
/**
* Unicode category constant Lt.
*
* @since Android 1.0
*/
public static final byte TITLECASE_LETTER = 3;
/**
* Unicode category constant Lm.
*
* @since Android 1.0
*/
public static final byte MODIFIER_LETTER = 4;
/**
* Unicode category constant Lo.
*
* @since Android 1.0
*/
public static final byte OTHER_LETTER = 5;
/**
* Unicode category constant Mn.
*
* @since Android 1.0
*/
public static final byte NON_SPACING_MARK = 6;
/**
* Unicode category constant Me.
*
* @since Android 1.0
*/
public static final byte ENCLOSING_MARK = 7;
/**
* Unicode category constant Mc.
*
* @since Android 1.0
*/
public static final byte COMBINING_SPACING_MARK = 8;
/**
* Unicode category constant Nd.
*
* @since Android 1.0
*/
public static final byte DECIMAL_DIGIT_NUMBER = 9;
/**
* Unicode category constant Nl.
*
* @since Android 1.0
*/
public static final byte LETTER_NUMBER = 10;
/**
* Unicode category constant No.
*
* @since Android 1.0
*/
public static final byte OTHER_NUMBER = 11;
/**
* Unicode category constant Zs.
*
* @since Android 1.0
*/
public static final byte SPACE_SEPARATOR = 12;
/**
* Unicode category constant Zl.
*
* @since Android 1.0
*/
public static final byte LINE_SEPARATOR = 13;
/**
* Unicode category constant Zp.
*
* @since Android 1.0
*/
public static final byte PARAGRAPH_SEPARATOR = 14;
/**
* Unicode category constant Cc.
*
* @since Android 1.0
*/
public static final byte CONTROL = 15;
/**
* Unicode category constant Cf.
*
* @since Android 1.0
*/
public static final byte FORMAT = 16;
/**
* Unicode category constant Co.
*
* @since Android 1.0
*/
public static final byte PRIVATE_USE = 18;
/**
* Unicode category constant Cs.
*
* @since Android 1.0
*/
public static final byte SURROGATE = 19;
/**
* Unicode category constant Pd.
*
* @since Android 1.0
*/
public static final byte DASH_PUNCTUATION = 20;
/**
* Unicode category constant Ps.
*
* @since Android 1.0
*/
public static final byte START_PUNCTUATION = 21;
/**
* Unicode category constant Pe.
*
* @since Android 1.0
*/
public static final byte END_PUNCTUATION = 22;
/**
* Unicode category constant Pc.
*
* @since Android 1.0
*/
public static final byte CONNECTOR_PUNCTUATION = 23;
/**
* Unicode category constant Po.
*
* @since Android 1.0
*/
public static final byte OTHER_PUNCTUATION = 24;
/**
* Unicode category constant Sm.
*
* @since Android 1.0
*/
public static final byte MATH_SYMBOL = 25;
/**
* Unicode category constant Sc.
*
* @since Android 1.0
*/
public static final byte CURRENCY_SYMBOL = 26;
/**
* Unicode category constant Sk.
*
* @since Android 1.0
*/
public static final byte MODIFIER_SYMBOL = 27;
/**
* Unicode category constant So.
*
* @since Android 1.0
*/
public static final byte OTHER_SYMBOL = 28;
/**
* Unicode category constant Pi.
*
* @since Android 1.0
*/
public static final byte INITIAL_QUOTE_PUNCTUATION = 29;
/**
* Unicode category constant Pf.
*
* @since Android 1.0
*/
public static final byte FINAL_QUOTE_PUNCTUATION = 30;
/**
* Unicode bidirectional constant.
*
* @since Android 1.0
*/
public static final byte DIRECTIONALITY_UNDEFINED = -1;
/**
* Unicode bidirectional constant L.
*
* @since Android 1.0
*/
public static final byte DIRECTIONALITY_LEFT_TO_RIGHT = 0;
/**
* Unicode bidirectional constant R.
*
* @since Android 1.0
*/
public static final byte DIRECTIONALITY_RIGHT_TO_LEFT = 1;
/**
* Unicode bidirectional constant AL.
*
* @since Android 1.0
*/
public static final byte DIRECTIONALITY_RIGHT_TO_LEFT_ARABIC = 2;
/**
* Unicode bidirectional constant EN.
*
* @since Android 1.0
*/
public static final byte DIRECTIONALITY_EUROPEAN_NUMBER = 3;
/**
* Unicode bidirectional constant ES.
*
* @since Android 1.0
*/
public static final byte DIRECTIONALITY_EUROPEAN_NUMBER_SEPARATOR = 4;
/**
* Unicode bidirectional constant ET.
*
* @since Android 1.0
*/
public static final byte DIRECTIONALITY_EUROPEAN_NUMBER_TERMINATOR = 5;
/**
* Unicode bidirectional constant AN.
*
* @since Android 1.0
*/
public static final byte DIRECTIONALITY_ARABIC_NUMBER = 6;
/**
* Unicode bidirectional constant CS.
*
* @since Android 1.0
*/
public static final byte DIRECTIONALITY_COMMON_NUMBER_SEPARATOR = 7;
/**
* Unicode bidirectional constant NSM.
*
* @since Android 1.0
*/
public static final byte DIRECTIONALITY_NONSPACING_MARK = 8;
/**
* Unicode bidirectional constant BN.
*
* @since Android 1.0
*/
public static final byte DIRECTIONALITY_BOUNDARY_NEUTRAL = 9;
/**
* Unicode bidirectional constant B.
*
* @since Android 1.0
*/
public static final byte DIRECTIONALITY_PARAGRAPH_SEPARATOR = 10;
/**
* Unicode bidirectional constant S.
*
* @since Android 1.0
*/
public static final byte DIRECTIONALITY_SEGMENT_SEPARATOR = 11;
/**
* Unicode bidirectional constant WS.
*
* @since Android 1.0
*/
public static final byte DIRECTIONALITY_WHITESPACE = 12;
/**
* Unicode bidirectional constant ON.
*
* @since Android 1.0
*/
public static final byte DIRECTIONALITY_OTHER_NEUTRALS = 13;
/**
* Unicode bidirectional constant LRE.
*
* @since Android 1.0
*/
public static final byte DIRECTIONALITY_LEFT_TO_RIGHT_EMBEDDING = 14;
/**
* Unicode bidirectional constant LRO.
*
* @since Android 1.0
*/
public static final byte DIRECTIONALITY_LEFT_TO_RIGHT_OVERRIDE = 15;
/**
* Unicode bidirectional constant RLE.
*
* @since Android 1.0
*/
public static final byte DIRECTIONALITY_RIGHT_TO_LEFT_EMBEDDING = 16;
/**
* Unicode bidirectional constant RLO.
*
* @since Android 1.0
*/
public static final byte DIRECTIONALITY_RIGHT_TO_LEFT_OVERRIDE = 17;
/**
* Unicode bidirectional constant PDF.
*
* @since Android 1.0
*/
public static final byte DIRECTIONALITY_POP_DIRECTIONAL_FORMAT = 18;
/**
* The minimum value of a high surrogate or leading surrogate unit in UTF-16
* encoding, {@code '\uD800'}.
*
* @since Android 1.0
*/
public static final char MIN_HIGH_SURROGATE = '\uD800';
/**
* The maximum value of a high surrogate or leading surrogate unit in UTF-16
* encoding, {@code '\uDBFF'}.
*
* @since Android 1.0
*/
public static final char MAX_HIGH_SURROGATE = '\uDBFF';
/**
* The minimum value of a low surrogate or trailing surrogate unit in UTF-16
* encoding, {@code '\uDC00'}.
*
* @since Android 1.0
*/
public static final char MIN_LOW_SURROGATE = '\uDC00';
/**
* The maximum value of a low surrogate or trailing surrogate unit in UTF-16
* encoding, {@code '\uDFFF'}.
*
* @since Android 1.0
*/
public static final char MAX_LOW_SURROGATE = '\uDFFF';
/**
* The minimum value of a surrogate unit in UTF-16 encoding, {@code '\uD800'}.
*
* @since Android 1.0
*/
public static final char MIN_SURROGATE = '\uD800';
/**
* The maximum value of a surrogate unit in UTF-16 encoding, {@code '\uDFFF'}.
*
* @since Android 1.0
*/
public static final char MAX_SURROGATE = '\uDFFF';
/**
* The minimum value of a supplementary code point, {@code U+010000}.
*
* @since Android 1.0
*/
public static final int MIN_SUPPLEMENTARY_CODE_POINT = 0x10000;
/**
* The minimum code point value, {@code U+0000}.
*
* @since Android 1.0
*/
public static final int MIN_CODE_POINT = 0x000000;
/**
* The maximum code point value, {@code U+10FFFF}.
*
* @since Android 1.0
*/
public static final int MAX_CODE_POINT = 0x10FFFF;
/**
* The number of bits required to represent a {@code Character} value in
* two's compliment form.
*
* @since Android 1.0
*/
public static final int SIZE = 16;
// BEGIN android-removed
// removed strings containing information about chars that now are read from
// icu data.
// END android-removed
private static final char[] typeTags = "\u0002\u0002\u0002\u0002\u0002\u0002\u0002\u0002\u0002\u0000\u0000\u0000\u0000\u0000\u0002\u0002\u0002\u0002\u0002\u0002\u0002\u0002\u0002\u0002\u0002\u0002\u0002\u0002\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0003\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0002\u0002\u0002\u0002\u0002\u0002\u0002\u0002\u0002\u0002\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0000\u0000\u0000\u0000\u0003\u0000\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0003\u0000\u0000\u0000\u0000\u0002"
.getValue();
private static final byte[] DIRECTIONALITY = new byte[] {
DIRECTIONALITY_LEFT_TO_RIGHT, DIRECTIONALITY_RIGHT_TO_LEFT,
DIRECTIONALITY_EUROPEAN_NUMBER,
DIRECTIONALITY_EUROPEAN_NUMBER_SEPARATOR,
DIRECTIONALITY_EUROPEAN_NUMBER_TERMINATOR,
DIRECTIONALITY_ARABIC_NUMBER,
DIRECTIONALITY_COMMON_NUMBER_SEPARATOR,
DIRECTIONALITY_PARAGRAPH_SEPARATOR,
DIRECTIONALITY_SEGMENT_SEPARATOR, DIRECTIONALITY_WHITESPACE,
DIRECTIONALITY_OTHER_NEUTRALS,
DIRECTIONALITY_LEFT_TO_RIGHT_EMBEDDING,
DIRECTIONALITY_LEFT_TO_RIGHT_OVERRIDE,
DIRECTIONALITY_RIGHT_TO_LEFT_ARABIC,
DIRECTIONALITY_RIGHT_TO_LEFT_EMBEDDING,
DIRECTIONALITY_RIGHT_TO_LEFT_OVERRIDE,
DIRECTIONALITY_POP_DIRECTIONAL_FORMAT,
DIRECTIONALITY_NONSPACING_MARK, DIRECTIONALITY_BOUNDARY_NEUTRAL };
private static final int ISJAVASTART = 1;
private static final int ISJAVAPART = 2;
// BEGIN android-removed
// removed strings containing information about chars that now are read from
// icu data.
// END android-removed
/**
* Represents a subset of the Unicode character set.
*
* @since Android 1.0
*/
public static class Subset {
String name;
/**
* Constructs a new {@code Subset}.
*
* @param string
* this subset's name.
* @since Android 1.0
*/
protected Subset(String string) {
if (string == null) {
throw new NullPointerException();
}
name = string;
}
/**
* Compares this character subset with the specified object. Uses
* {@link java.lang.Object#equals(Object)} to do the comparison.
*
* @param object
* the object to compare this character subset with.
* @return {@code true} if {@code object} is this subset, that is, if
* {@code object == this}; {@code false} otherwise.
* @since Android 1.0
*/
@Override
public final boolean equals(Object object) {
return super.equals(object);
}
/**
* Returns the integer hash code for this character subset.
*
* @return this subset's hash code, which is the hash code computed by
* {@link java.lang.Object#hashCode()}.
* @since Android 1.0
*/
@Override
public final int hashCode() {
return super.hashCode();
}
/**
* Returns the string representation of this subset.
*
* @return this subset's name.
* @since Android 1.0
*/
@Override
public final String toString() {
return name;
}
}
// BEGIN android-changed
/**
* Represents a block of Unicode characters, as defined by the Unicode 4.0.1
* specification.
*
* @since Android 1.0
*/
public static final class UnicodeBlock extends Subset {
/**
* The "Surrogates Area" Unicode Block.
*
* @deprecated As of Java 5, this block has been replaced by
* {@link #HIGH_SURROGATES},
* {@link #HIGH_PRIVATE_USE_SURROGATES} and
* {@link #LOW_SURROGATES}.
* @since Android 1.0
*/
@Deprecated
public static final UnicodeBlock SURROGATES_AREA = new UnicodeBlock("SURROGATES_AREA");
/**
* The "Basic Latin" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock BASIC_LATIN = new UnicodeBlock("BASIC_LATIN");
/**
* The "Latin-1 Supplement" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock LATIN_1_SUPPLEMENT = new UnicodeBlock("LATIN_1_SUPPLEMENT");
/**
* The "Latin Extended-A" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock LATIN_EXTENDED_A = new UnicodeBlock("LATIN_EXTENDED_A");
/**
* The "Latin Extended-B" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock LATIN_EXTENDED_B = new UnicodeBlock("LATIN_EXTENDED_B");
/**
* The "IPA Extensions" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock IPA_EXTENSIONS = new UnicodeBlock("IPA_EXTENSIONS");
/**
* The "Spacing Modifier Letters" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock SPACING_MODIFIER_LETTERS = new UnicodeBlock("SPACING_MODIFIER_LETTERS");
/**
* The "Combining Diacritical Marks" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock COMBINING_DIACRITICAL_MARKS = new UnicodeBlock("COMBINING_DIACRITICAL_MARKS");
/**
* The "Greek and Coptic" Unicode Block. Previously referred
* to as "Greek".
*
* @since Android 1.0
*/
public static final UnicodeBlock GREEK = new UnicodeBlock("GREEK");
/**
* The "Cyrillic" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock CYRILLIC = new UnicodeBlock("CYRILLIC");
/**
* The "Cyrillic Supplement" Unicode Block. Previously
* referred to as "Cyrillic Supplementary".
*
* @since Android 1.0
*/
public static final UnicodeBlock CYRILLIC_SUPPLEMENTARY = new UnicodeBlock("CYRILLIC_SUPPLEMENTARY");
/**
* The "Armenian" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock ARMENIAN = new UnicodeBlock("ARMENIAN");
/**
* The "Hebrew" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock HEBREW = new UnicodeBlock("HEBREW");
/**
* The "Arabic" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock ARABIC = new UnicodeBlock("ARABIC");
/**
* The "Syriac" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock SYRIAC = new UnicodeBlock("SYRIAC");
/**
* The "Thaana" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock THAANA = new UnicodeBlock("THAANA");
/**
* The "Devanagari" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock DEVANAGARI = new UnicodeBlock("DEVANAGARI");
/**
* The "Bengali" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock BENGALI = new UnicodeBlock("BENGALI");
/**
* The "Gurmukhi" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock GURMUKHI = new UnicodeBlock("GURMUKHI");
/**
* The "Gujarati" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock GUJARATI = new UnicodeBlock("GUJARATI");
/**
* The "Oriya" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock ORIYA = new UnicodeBlock("ORIYA");
/**
* The "Tamil" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock TAMIL = new UnicodeBlock("TAMIL");
/**
* The "Telugu" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock TELUGU = new UnicodeBlock("TELUGU");
/**
* The "Kannada" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock KANNADA = new UnicodeBlock("KANNADA");
/**
* The "Malayalam" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock MALAYALAM = new UnicodeBlock("MALAYALAM");
/**
* The "Sinhala" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock SINHALA = new UnicodeBlock("SINHALA");
/**
* The "Thai" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock THAI = new UnicodeBlock("THAI");
/**
* The "Lao" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock LAO = new UnicodeBlock("LAO");
/**
* The "Tibetan" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock TIBETAN = new UnicodeBlock("TIBETAN");
/**
* The "Myanmar" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock MYANMAR = new UnicodeBlock("MYANMAR");
/**
* The "Georgian" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock GEORGIAN = new UnicodeBlock("GEORGIAN");
/**
* The "Hangul Jamo" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock HANGUL_JAMO = new UnicodeBlock("HANGUL_JAMO");
/**
* The "Ethiopic" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock ETHIOPIC = new UnicodeBlock("ETHIOPIC");
/**
* The "Cherokee" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock CHEROKEE = new UnicodeBlock("CHEROKEE");
/**
* The "Unified Canadian Aboriginal Syllabics" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock UNIFIED_CANADIAN_ABORIGINAL_SYLLABICS = new UnicodeBlock("UNIFIED_CANADIAN_ABORIGINAL_SYLLABICS");
/**
* The "Ogham" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock OGHAM = new UnicodeBlock("OGHAM");
/**
* The "Runic" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock RUNIC = new UnicodeBlock("RUNIC");
/**
* The "Tagalog" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock TAGALOG = new UnicodeBlock("TAGALOG");
/**
* The "Hanunoo" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock HANUNOO = new UnicodeBlock("HANUNOO");
/**
* The "Buhid" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock BUHID = new UnicodeBlock("BUHID");
/**
* The "Tagbanwa" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock TAGBANWA = new UnicodeBlock("TAGBANWA");
/**
* The "Khmer" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock KHMER = new UnicodeBlock("KHMER");
/**
* The "Mongolian" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock MONGOLIAN = new UnicodeBlock("MONGOLIAN");
/**
* The "Limbu" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock LIMBU = new UnicodeBlock("LIMBU");
/**
* The "Tai Le" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock TAI_LE = new UnicodeBlock("TAI_LE");
/**
* The "Khmer Symbols" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock KHMER_SYMBOLS = new UnicodeBlock("KHMER_SYMBOLS");
/**
* The "Phonetic Extensions" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock PHONETIC_EXTENSIONS = new UnicodeBlock("PHONETIC_EXTENSIONS");
/**
* The "Latin Extended Additional" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock LATIN_EXTENDED_ADDITIONAL = new UnicodeBlock("LATIN_EXTENDED_ADDITIONAL");
/**
* The "Greek Extended" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock GREEK_EXTENDED = new UnicodeBlock("GREEK_EXTENDED");
/**
* The "General Punctuation" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock GENERAL_PUNCTUATION = new UnicodeBlock("GENERAL_PUNCTUATION");
/**
* The "Superscripts and Subscripts" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock SUPERSCRIPTS_AND_SUBSCRIPTS = new UnicodeBlock("SUPERSCRIPTS_AND_SUBSCRIPTS");
/**
* The "Currency Symbols" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock CURRENCY_SYMBOLS = new UnicodeBlock("CURRENCY_SYMBOLS");
/**
* The "Combining Diacritical Marks for Symbols" Unicode
* Block. Previously referred to as "Combining Marks for
* Symbols".
*
* @since Android 1.0
*/
public static final UnicodeBlock COMBINING_MARKS_FOR_SYMBOLS = new UnicodeBlock("COMBINING_MARKS_FOR_SYMBOLS");
/**
* The "Letterlike Symbols" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock LETTERLIKE_SYMBOLS = new UnicodeBlock("LETTERLIKE_SYMBOLS");
/**
* The "Number Forms" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock NUMBER_FORMS = new UnicodeBlock("NUMBER_FORMS");
/**
* The "Arrows" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock ARROWS = new UnicodeBlock("ARROWS");
/**
* The "Mathematical Operators" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock MATHEMATICAL_OPERATORS = new UnicodeBlock("MATHEMATICAL_OPERATORS");
/**
* The "Miscellaneous Technical" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock MISCELLANEOUS_TECHNICAL = new UnicodeBlock("MISCELLANEOUS_TECHNICAL");
/**
* The "Control Pictures" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock CONTROL_PICTURES = new UnicodeBlock("CONTROL_PICTURES");
/**
* The "Optical Character Recognition" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock OPTICAL_CHARACTER_RECOGNITION = new UnicodeBlock("OPTICAL_CHARACTER_RECOGNITION");
/**
* The "Enclosed Alphanumerics" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock ENCLOSED_ALPHANUMERICS = new UnicodeBlock("ENCLOSED_ALPHANUMERICS");
/**
* The "Box Drawing" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock BOX_DRAWING = new UnicodeBlock("BOX_DRAWING");
/**
* The "Block Elements" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock BLOCK_ELEMENTS = new UnicodeBlock("BLOCK_ELEMENTS");
/**
* The "Geometric Shapes" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock GEOMETRIC_SHAPES = new UnicodeBlock("GEOMETRIC_SHAPES");
/**
* The "Miscellaneous Symbols" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock MISCELLANEOUS_SYMBOLS = new UnicodeBlock("MISCELLANEOUS_SYMBOLS");
/**
* The "Dingbats" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock DINGBATS = new UnicodeBlock("DINGBATS");
/**
* The "Miscellaneous Mathematical Symbols-A" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock MISCELLANEOUS_MATHEMATICAL_SYMBOLS_A = new UnicodeBlock("MISCELLANEOUS_MATHEMATICAL_SYMBOLS_A");
/**
* The "Supplemental Arrows-A" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock SUPPLEMENTAL_ARROWS_A = new UnicodeBlock("SUPPLEMENTAL_ARROWS_A");
/**
* The "Braille Patterns" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock BRAILLE_PATTERNS = new UnicodeBlock("BRAILLE_PATTERNS");
/**
* The "Supplemental Arrows-B" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock SUPPLEMENTAL_ARROWS_B = new UnicodeBlock("SUPPLEMENTAL_ARROWS_B");
/**
* The "Miscellaneous Mathematical Symbols-B" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock MISCELLANEOUS_MATHEMATICAL_SYMBOLS_B = new UnicodeBlock("MISCELLANEOUS_MATHEMATICAL_SYMBOLS_B");
/**
* The "Supplemental Mathematical Operators" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock SUPPLEMENTAL_MATHEMATICAL_OPERATORS = new UnicodeBlock("SUPPLEMENTAL_MATHEMATICAL_OPERATORS");
/**
* The "Miscellaneous Symbols and Arrows" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock MISCELLANEOUS_SYMBOLS_AND_ARROWS = new UnicodeBlock("MISCELLANEOUS_SYMBOLS_AND_ARROWS");
/**
* The "CJK Radicals Supplement" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock CJK_RADICALS_SUPPLEMENT = new UnicodeBlock("CJK_RADICALS_SUPPLEMENT");
/**
* The "Kangxi Radicals" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock KANGXI_RADICALS = new UnicodeBlock("KANGXI_RADICALS");
/**
* The "Ideographic Description Characters" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock IDEOGRAPHIC_DESCRIPTION_CHARACTERS = new UnicodeBlock("IDEOGRAPHIC_DESCRIPTION_CHARACTERS");
/**
* The "CJK Symbols and Punctuation" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock CJK_SYMBOLS_AND_PUNCTUATION = new UnicodeBlock("CJK_SYMBOLS_AND_PUNCTUATION");
/**
* The "Hiragana" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock HIRAGANA = new UnicodeBlock("HIRAGANA");
/**
* The "Katakana" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock KATAKANA = new UnicodeBlock("KATAKANA");
/**
* The "Bopomofo" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock BOPOMOFO = new UnicodeBlock("BOPOMOFO");
/**
* The "Hangul Compatibility Jamo" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock HANGUL_COMPATIBILITY_JAMO = new UnicodeBlock("HANGUL_COMPATIBILITY_JAMO");
/**
* The "Kanbun" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock KANBUN = new UnicodeBlock("KANBUN");
/**
* The "Bopomofo Extended" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock BOPOMOFO_EXTENDED = new UnicodeBlock("BOPOMOFO_EXTENDED");
/**
* The "Katakana Phonetic Extensions" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock KATAKANA_PHONETIC_EXTENSIONS = new UnicodeBlock("KATAKANA_PHONETIC_EXTENSIONS");
/**
* The "Enclosed CJK Letters and Months" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock ENCLOSED_CJK_LETTERS_AND_MONTHS = new UnicodeBlock("ENCLOSED_CJK_LETTERS_AND_MONTHS");
/**
* The "CJK Compatibility" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock CJK_COMPATIBILITY = new UnicodeBlock("CJK_COMPATIBILITY");
/**
* The "CJK Unified Ideographs Extension A" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock CJK_UNIFIED_IDEOGRAPHS_EXTENSION_A = new UnicodeBlock("CJK_UNIFIED_IDEOGRAPHS_EXTENSION_A");
/**
* The "Yijing Hexagram Symbols" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock YIJING_HEXAGRAM_SYMBOLS = new UnicodeBlock("YIJING_HEXAGRAM_SYMBOLS");
/**
* The "CJK Unified Ideographs" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock CJK_UNIFIED_IDEOGRAPHS = new UnicodeBlock("CJK_UNIFIED_IDEOGRAPHS");
/**
* The "Yi Syllables" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock YI_SYLLABLES = new UnicodeBlock("YI_SYLLABLES");
/**
* The "Yi Radicals" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock YI_RADICALS = new UnicodeBlock("YI_RADICALS");
/**
* The "Hangul Syllables" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock HANGUL_SYLLABLES = new UnicodeBlock("HANGUL_SYLLABLES");
/**
* The "High Surrogates" Unicode Block. This block represents
* code point values in the high surrogate range 0xD800 to 0xDB7F
*
* @since Android 1.0
*/
public static final UnicodeBlock HIGH_SURROGATES = new UnicodeBlock("HIGH_SURROGATES");
/**
* The "High Private Use Surrogates" Unicode Block. This block
* represents code point values in the high surrogate range 0xDB80 to
* 0xDBFF
*
* @since Android 1.0
*/
public static final UnicodeBlock HIGH_PRIVATE_USE_SURROGATES = new UnicodeBlock("HIGH_PRIVATE_USE_SURROGATES");
/**
* The "Low Surrogates" Unicode Block. This block represents
* code point values in the low surrogate range 0xDC00 to 0xDFFF
*
* @since Android 1.0
*/
public static final UnicodeBlock LOW_SURROGATES = new UnicodeBlock("LOW_SURROGATES");
/**
* The "Private Use Area" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock PRIVATE_USE_AREA = new UnicodeBlock("PRIVATE_USE_AREA");
/**
* The "CJK Compatibility Ideographs" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock CJK_COMPATIBILITY_IDEOGRAPHS = new UnicodeBlock("CJK_COMPATIBILITY_IDEOGRAPHS");
/**
* The "Alphabetic Presentation Forms" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock ALPHABETIC_PRESENTATION_FORMS = new UnicodeBlock("ALPHABETIC_PRESENTATION_FORMS");
/**
* The "Arabic Presentation Forms-A" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock ARABIC_PRESENTATION_FORMS_A = new UnicodeBlock("ARABIC_PRESENTATION_FORMS_A");
/**
* The "Variation Selectors" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock VARIATION_SELECTORS = new UnicodeBlock("VARIATION_SELECTORS");
/**
* The "Combining Half Marks" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock COMBINING_HALF_MARKS = new UnicodeBlock("COMBINING_HALF_MARKS");
/**
* The "CJK Compatibility Forms" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock CJK_COMPATIBILITY_FORMS = new UnicodeBlock("CJK_COMPATIBILITY_FORMS");
/**
* The "Small Form Variants" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock SMALL_FORM_VARIANTS = new UnicodeBlock("SMALL_FORM_VARIANTS");
/**
* The "Arabic Presentation Forms-B" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock ARABIC_PRESENTATION_FORMS_B = new UnicodeBlock("ARABIC_PRESENTATION_FORMS_B");
/**
* The "Halfwidth and Fullwidth Forms" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock HALFWIDTH_AND_FULLWIDTH_FORMS = new UnicodeBlock("HALFWIDTH_AND_FULLWIDTH_FORMS");
/**
* The "Specials" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock SPECIALS = new UnicodeBlock("SPECIALS");
/**
* The "Linear B Syllabary" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock LINEAR_B_SYLLABARY = new UnicodeBlock("LINEAR_B_SYLLABARY");
/**
* The "Linear B Ideograms" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock LINEAR_B_IDEOGRAMS = new UnicodeBlock("LINEAR_B_IDEOGRAMS");
/**
* The "Aegean Numbers" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock AEGEAN_NUMBERS = new UnicodeBlock("AEGEAN_NUMBERS");
/**
* The "Old Italic" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock OLD_ITALIC = new UnicodeBlock("OLD_ITALIC");
/**
* The "Gothic" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock GOTHIC = new UnicodeBlock("GOTHIC");
/**
* The "Ugaritic" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock UGARITIC = new UnicodeBlock("UGARITIC");
/**
* The "Deseret" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock DESERET = new UnicodeBlock("DESERET");
/**
* The "Shavian" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock SHAVIAN = new UnicodeBlock("SHAVIAN");
/**
* The "Osmanya" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock OSMANYA = new UnicodeBlock("OSMANYA");
/**
* The "Cypriot Syllabary" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock CYPRIOT_SYLLABARY = new UnicodeBlock("CYPRIOT_SYLLABARY");
/**
* The "Byzantine Musical Symbols" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock BYZANTINE_MUSICAL_SYMBOLS = new UnicodeBlock("BYZANTINE_MUSICAL_SYMBOLS");
/**
* The "Musical Symbols" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock MUSICAL_SYMBOLS = new UnicodeBlock("MUSICAL_SYMBOLS");
/**
* The "Tai Xuan Jing Symbols" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock TAI_XUAN_JING_SYMBOLS = new UnicodeBlock("TAI_XUAN_JING_SYMBOLS");
/**
* The "Mathematical Alphanumeric Symbols" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock MATHEMATICAL_ALPHANUMERIC_SYMBOLS = new UnicodeBlock("MATHEMATICAL_ALPHANUMERIC_SYMBOLS");
/**
* The "CJK Unified Ideographs Extension B" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock CJK_UNIFIED_IDEOGRAPHS_EXTENSION_B = new UnicodeBlock("CJK_UNIFIED_IDEOGRAPHS_EXTENSION_B");
/**
* The "CJK Compatibility Ideographs Supplement" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock CJK_COMPATIBILITY_IDEOGRAPHS_SUPPLEMENT = new UnicodeBlock("CJK_COMPATIBILITY_IDEOGRAPHS_SUPPLEMENT");
/**
* The "Tags" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock TAGS = new UnicodeBlock("TAGS");
/**
* The "Variation Selectors Supplement" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock VARIATION_SELECTORS_SUPPLEMENT = new UnicodeBlock("VARIATION_SELECTORS_SUPPLEMENT");
/**
* The "Supplementary Private Use Area-A" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock SUPPLEMENTARY_PRIVATE_USE_AREA_A = new UnicodeBlock("SUPPLEMENTARY_PRIVATE_USE_AREA_A");
/**
* The "Supplementary Private Use Area-B" Unicode Block.
*
* @since Android 1.0
*/
public static final UnicodeBlock SUPPLEMENTARY_PRIVATE_USE_AREA_B = new UnicodeBlock("SUPPLEMENTARY_PRIVATE_USE_AREA_B");
/*
* All of the UnicodeBlocks with valid ranges in ascending order.
*/
private static UnicodeBlock[] BLOCKS;
// END android-changed
/**
* Retrieves the constant that corresponds to the specified block name.
* The block names are defined by the Unicode 4.0.1 specification in the
* {@code Blocks-4.0.1.txt} file.
* <p>
* Block names may be one of the following:
* </p>
* <ul>
* <li>Canonical block name, as defined by the Unicode specification;
* case-insensitive.</li>
* <li>Canonical block name without any spaces, as defined by the
* Unicode specification; case-insensitive.</li>
* <li>{@code UnicodeBlock} constant identifier. This is determined by
* uppercasing the canonical name and replacing all spaces and hyphens
* with underscores.</li>
* </ul>
*
* @param blockName
* the name of the block to retrieve.
* @return the UnicodeBlock constant corresponding to {@code blockName}.
* @throws IllegalArgumentException
* if {@code blockName} is not a valid block name.
* @since Android 1.0
*/
public static final UnicodeBlock forName(String blockName) {
// BEGIN android-note
// trying to get closer to the RI which defines this as final.
// END android-note
if (blockName == null) {
throw new NullPointerException();
}
// BEGIN android-changed
if (BLOCKS == null) {
BLOCKS = UCharacter.getBlockTable();
}
int block = UCharacter.forName(blockName);
if (block == -1) {
if(blockName.equals("SURROGATES_AREA")) {
return SURROGATES_AREA;
} else if(blockName.equalsIgnoreCase("greek")) {
return GREEK;
} else if(blockName.equals("COMBINING_MARKS_FOR_SYMBOLS") ||
blockName.equals("Combining Marks for Symbols") ||
blockName.equals("CombiningMarksforSymbols")) {
return COMBINING_MARKS_FOR_SYMBOLS;
}
throw new IllegalArgumentException();
}
return BLOCKS[block];
// END android-changed
}
/**
* Gets the constant for the Unicode block that contains the specified
* character.
*
* @param c
* the character for which to get the {@code UnicodeBlock}
* constant.
* @return the {@code UnicodeBlock} constant for the block that contains
* {@code c}, or {@code null} if {@code c} does not belong to
* any defined block.
* @since Android 1.0
*/
public static UnicodeBlock of(char c) {
return of((int) c);
}
/**
* Gets the constant for the Unicode block that contains the specified
* Unicode code point.
*
* @param codePoint
* the Unicode code point for which to get the
* {@code UnicodeBlock} constant.
* @return the {@code UnicodeBlock} constant for the block that contains
* {@code codePoint}, or {@code null} if {@code codePoint} does
* not belong to any defined block.
* @throws IllegalArgumentException
* if {@code codePoint} is not a valid Unicode code point.
* @since Android 1.0
*/
public static UnicodeBlock of(int codePoint) {
if (!isValidCodePoint(codePoint)) {
throw new IllegalArgumentException();
}
// BEGIN android-changed
if (BLOCKS == null) {
BLOCKS = UCharacter.getBlockTable();
}
int block = UCharacter.of(codePoint);
if(block == -1 || block >= BLOCKS.length) {
return null;
}
return BLOCKS[block];
// END android-changed
}
// BEGIN android-changed
private UnicodeBlock(String blockName) {
super(blockName);
}
// END android-changed
}
/**
* Constructs a new {@code Character} with the specified primitive char
* value.
*
* @param value
* the primitive char value to store in the new instance.
* @since Android 1.0
*/
public Character(char value) {
this.value = value;
}
/**
* Gets the primitive value of this character.
*
* @return this object's primitive value.
* @since Android 1.0
*/
public char charValue() {
return value;
}
/**
* Compares this object to the specified character object to determine their
* relative order.
*
* @param c
* the character object to compare this object to.
* @return {@code 0} if the value of this character and the value of
* {@code c} are equal; a positive value if the value of this
* character is greater than the value of {@code c}; a negative
* value if the value of this character is less than the value of
* {@code c}.
* @see java.lang.Comparable
* @since Android 1.0
*/
public int compareTo(Character c) {
return value - c.value;
}
/**
* Returns a {@code Character} instance for the {@code char} value passed.
* For ASCII/Latin-1 characters (and generally all characters with a Unicode
* value up to 512), this method should be used instead of the constructor,
* as it maintains a cache of corresponding {@code Character} instances.
*
* @param c
* the char value for which to get a {@code Character} instance.
* @return the {@code Character} instance for {@code c}.
* @since Android 1.0
*/
public static Character valueOf(char c) {
if (c >= CACHE_LEN ) {
return new Character(c);
}
return valueOfCache.CACHE[c];
}
private static final int CACHE_LEN = 512;
static class valueOfCache {
/*
* Provides a cache for the 'valueOf' method. A size of 512 should cache the
* first couple pages of Unicode, which includes the ASCII/Latin-1
* characters, which other parts of this class are optimized for.
*/
private static final Character[] CACHE = new Character[CACHE_LEN ];
static {
for(int i=0; i<CACHE.length; i++){
CACHE[i] = new Character((char)i);
}
}
}
/**
* Indicates whether {@code codePoint} is a valid Unicode code point.
*
* @param codePoint
* the code point to test.
* @return {@code true} if {@code codePoint} is a valid Unicode code point;
* {@code false} otherwise.
* @since Android 1.0
*/
public static boolean isValidCodePoint(int codePoint) {
return (MIN_CODE_POINT <= codePoint && MAX_CODE_POINT >= codePoint);
}
/**
* Indicates whether {@code codePoint} is within the supplementary code
* point range.
*
* @param codePoint
* the code point to test.
* @return {@code true} if {@code codePoint} is within the supplementary
* code point range; {@code false} otherwise.
* @since Android 1.0
*/
public static boolean isSupplementaryCodePoint(int codePoint) {
return (MIN_SUPPLEMENTARY_CODE_POINT <= codePoint && MAX_CODE_POINT >= codePoint);
}
/**
* Indicates whether {@code ch} is a high- (or leading-) surrogate code unit
* that is used for representing supplementary characters in UTF-16
* encoding.
*
* @param ch
* the character to test.
* @return {@code true} if {@code ch} is a high-surrogate code unit;
* {@code false} otherwise.
* @see #isLowSurrogate(char)
* @since Android 1.0
*/
public static boolean isHighSurrogate(char ch) {
return (MIN_HIGH_SURROGATE <= ch && MAX_HIGH_SURROGATE >= ch);
}
/**
* Indicates whether {@code ch} is a low- (or trailing-) surrogate code unit
* that is used for representing supplementary characters in UTF-16
* encoding.
*
* @param ch
* the character to test.
* @return {@code true} if {@code ch} is a low-surrogate code unit;
* {@code false} otherwise.
* @see #isHighSurrogate(char)
* @since Android 1.0
*/
public static boolean isLowSurrogate(char ch) {
return (MIN_LOW_SURROGATE <= ch && MAX_LOW_SURROGATE >= ch);
}
/**
* Indicates whether the specified character pair is a valid surrogate pair.
*
* @param high
* the high surrogate unit to test.
* @param low
* the low surrogate unit to test.
* @return {@code true} if {@code high} is a high-surrogate code unit and
* {@code low} is a low-surrogate code unit; {@code false}
* otherwise.
* @see #isHighSurrogate(char)
* @see #isLowSurrogate(char)
* @since Android 1.0
*/
public static boolean isSurrogatePair(char high, char low) {
return (isHighSurrogate(high) && isLowSurrogate(low));
}
/**
* Calculates the number of {@code char} values required to represent the
* specified Unicode code point. This method checks if the {@code codePoint}
* is greater than or equal to {@code 0x10000}, in which case {@code 2} is
* returned, otherwise {@code 1}. To test if the code point is valid, use
* the {@link #isValidCodePoint(int)} method.
*
* @param codePoint
* the code point for which to calculate the number of required
* chars.
* @return {@code 2} if {@code codePoint >= 0x10000}; {@code 1} otherwise.
* @since Android 1.0
*/
public static int charCount(int codePoint) {
return (codePoint >= 0x10000 ? 2 : 1);
}
/**
* Converts a surrogate pair into a Unicode code point. This method assumes
* that the pair are valid surrogates. If the pair are <i>not</i> valid
* surrogates, then the result is indeterminate. The
* {@link #isSurrogatePair(char, char)} method should be used prior to this
* method to validate the pair.
*
* @param high
* the high surrogate unit.
* @param low
* the low surrogate unit.
* @return the Unicode code point corresponding to the surrogate unit pair.
* @see #isSurrogatePair(char, char)
* @since Android 1.0
*/
public static int toCodePoint(char high, char low) {
// See RFC 2781, Section 2.2
// http://www.faqs.org/rfcs/rfc2781.html
int h = (high & 0x3FF) << 10;
int l = low & 0x3FF;
return (h | l) + 0x10000;
}
/**
* Returns the code point at {@code index} in the specified sequence of
* character units. If the unit at {@code index} is a high-surrogate unit,
* {@code index + 1} is less than the length of the sequence and the unit at
* {@code index + 1} is a low-surrogate unit, then the supplementary code
* point represented by the pair is returned; otherwise the {@code char}
* value at {@code index} is returned.
*
* @param seq
* the source sequence of {@code char} units.
* @param index
* the position in {@code seq} from which to retrieve the code
* point.
* @return the Unicode code point or {@code char} value at {@code index} in
* {@code seq}.
* @throws IndexOutOfBoundsException
* if the {@code index} is negative or greater than or equal to
* the length of {@code seq}.
* @since Android 1.0
*/
public static int codePointAt(CharSequence seq, int index) {
if (seq == null) {
throw new NullPointerException();
}
int len = seq.length();
if (index < 0 || index >= len) {
throw new IndexOutOfBoundsException();
}
char high = seq.charAt(index++);
if (index >= len) {
return high;
}
char low = seq.charAt(index);
if (isSurrogatePair(high, low)) {
return toCodePoint(high, low);
}
return high;
}
/**
* Returns the code point at {@code index} in the specified array of
* character units. If the unit at {@code index} is a high-surrogate unit,
* {@code index + 1} is less than the length of the array and the unit at
* {@code index + 1} is a low-surrogate unit, then the supplementary code
* point represented by the pair is returned; otherwise the {@code char}
* value at {@code index} is returned.
*
* @param seq
* the source array of {@code char} units.
* @param index
* the position in {@code seq} from which to retrieve the code
* point.
* @return the Unicode code point or {@code char} value at {@code index} in
* {@code seq}.
* @throws IndexOutOfBoundsException
* if the {@code index} is negative or greater than or equal to
* the length of {@code seq}.
* @since Android 1.0
*/
public static int codePointAt(char[] seq, int index) {
if (seq == null) {
throw new NullPointerException();
}
int len = seq.length;
if (index < 0 || index >= len) {
throw new IndexOutOfBoundsException();
}
char high = seq[index++];
if (index >= len) {
return high;
}
char low = seq[index];
if (isSurrogatePair(high, low)) {
return toCodePoint(high, low);
}
return high;
}
/**
* Returns the code point at {@code index} in the specified array of
* character units, where {@code index} has to be less than {@code limit}.
* If the unit at {@code index} is a high-surrogate unit, {@code index + 1}
* is less than {@code limit} and the unit at {@code index + 1} is a
* low-surrogate unit, then the supplementary code point represented by the
* pair is returned; otherwise the {@code char} value at {@code index} is
* returned.
*
* @param seq
* the source array of {@code char} units.
* @param index
* the position in {@code seq} from which to get the code point.
* @param limit
* the index after the last unit in {@code seq} that can be used.
* @return the Unicode code point or {@code char} value at {@code index} in
* {@code seq}.
* @throws IndexOutOfBoundsException
* if {@code index < 0}, {@code index >= limit},
* {@code limit < 0} or if {@code limit} is greater than the
* length of {@code seq}.
* @since Android 1.0
*/
public static int codePointAt(char[] seq, int index, int limit) {
if (index < 0 || index >= limit || limit < 0 || limit > seq.length) {
throw new IndexOutOfBoundsException();
}
char high = seq[index++];
if (index >= limit) {
return high;
}
char low = seq[index];
if (isSurrogatePair(high, low)) {
return toCodePoint(high, low);
}
return high;
}
/**
* Returns the code point that preceds {@code index} in the specified
* sequence of character units. If the unit at {@code index - 1} is a
* low-surrogate unit, {@code index - 2} is not negative and the unit at
* {@code index - 2} is a high-surrogate unit, then the supplementary code
* point represented by the pair is returned; otherwise the {@code char}
* value at {@code index - 1} is returned.
*
* @param seq
* the source sequence of {@code char} units.
* @param index
* the position in {@code seq} following the code
* point that should be returned.
* @return the Unicode code point or {@code char} value before {@code index}
* in {@code seq}.
* @throws IndexOutOfBoundsException
* if the {@code index} is less than 1 or greater than the
* length of {@code seq}.
* @since Android 1.0
*/
public static int codePointBefore(CharSequence seq, int index) {
if (seq == null) {
throw new NullPointerException();
}
int len = seq.length();
if (index < 1 || index > len) {
throw new IndexOutOfBoundsException();
}
char low = seq.charAt(--index);
if (--index < 0) {
return low;
}
char high = seq.charAt(index);
if (isSurrogatePair(high, low)) {
return toCodePoint(high, low);
}
return low;
}
/**
* Returns the code point that preceds {@code index} in the specified
* array of character units. If the unit at {@code index - 1} is a
* low-surrogate unit, {@code index - 2} is not negative and the unit at
* {@code index - 2} is a high-surrogate unit, then the supplementary code
* point represented by the pair is returned; otherwise the {@code char}
* value at {@code index - 1} is returned.
*
* @param seq
* the source array of {@code char} units.
* @param index
* the position in {@code seq} following the code
* point that should be returned.
* @return the Unicode code point or {@code char} value before {@code index}
* in {@code seq}.
* @throws IndexOutOfBoundsException
* if the {@code index} is less than 1 or greater than the
* length of {@code seq}.
* @since Android 1.0
*/
public static int codePointBefore(char[] seq, int index) {
if (seq == null) {
throw new NullPointerException();
}
int len = seq.length;
if (index < 1 || index > len) {
throw new IndexOutOfBoundsException();
}
char low = seq[--index];
if (--index < 0) {
return low;
}
char high = seq[index];
if (isSurrogatePair(high, low)) {
return toCodePoint(high, low);
}
return low;
}
/**
* Returns the code point that preceds the {@code index} in the specified
* array of character units and is not less than {@code start}. If the unit
* at {@code index - 1} is a low-surrogate unit, {@code index - 2} is not
* less than {@code start} and the unit at {@code index - 2} is a
* high-surrogate unit, then the supplementary code point represented by the
* pair is returned; otherwise the {@code char} value at {@code index - 1}
* is returned.
*
* @param seq
* the source array of {@code char} units.
* @param index
* the position in {@code seq} following the code point that
* should be returned.
* @param start
* the index of the first element in {@code seq}.
* @return the Unicode code point or {@code char} value before {@code index}
* in {@code seq}.
* @throws IndexOutOfBoundsException
* if the {@code index <= start}, {@code start < 0},
* {@code index} is greater than the length of {@code seq}, or
* if {@code start} is equal or greater than the length of
* {@code seq}.
* @since Android 1.0
*/
public static int codePointBefore(char[] seq, int index, int start) {
if (seq == null) {
throw new NullPointerException();
}
int len = seq.length;
if (index <= start || index > len || start < 0 || start >= len) {
throw new IndexOutOfBoundsException();
}
char low = seq[--index];
if (--index < start) {
return low;
}
char high = seq[index];
if (isSurrogatePair(high, low)) {
return toCodePoint(high, low);
}
return low;
}
/**
* Converts the specified Unicode code point into a UTF-16 encoded sequence
* and copies the value(s) into the char array {@code dst}, starting at
* index {@code dstIndex}.
*
* @param codePoint
* the Unicode code point to encode.
* @param dst
* the destination array to copy the encoded value into.
* @param dstIndex
* the index in {@code dst} from where to start copying.
* @return the number of {@code char} value units copied into {@code dst}.
* @throws IllegalArgumentException
* if {@code codePoint} is not a valid Unicode code point.
* @throws IndexOutOfBoundsException
* if {@code dstIndex} is negative, greater than or equal to
* {@code dst.length} or equals {@code dst.length - 1} when
* {@code codePoint} is a
* {@link #isSupplementaryCodePoint(int) supplementary code point}.
* @since Android 1.0
*/
public static int toChars(int codePoint, char[] dst, int dstIndex) {
if (!isValidCodePoint(codePoint)) {
throw new IllegalArgumentException();
}
if (dst == null) {
throw new NullPointerException();
}
if (dstIndex < 0 || dstIndex >= dst.length) {
throw new IndexOutOfBoundsException();
}
if (isSupplementaryCodePoint(codePoint)) {
if (dstIndex == dst.length - 1) {
throw new IndexOutOfBoundsException();
}
// See RFC 2781, Section 2.1
// http://www.faqs.org/rfcs/rfc2781.html
int cpPrime = codePoint - 0x10000;
int high = 0xD800 | ((cpPrime >> 10) & 0x3FF);
int low = 0xDC00 | (cpPrime & 0x3FF);
dst[dstIndex] = (char) high;
dst[dstIndex + 1] = (char) low;
return 2;
}
dst[dstIndex] = (char) codePoint;
return 1;
}
/**
* Converts the specified Unicode code point into a UTF-16 encoded sequence
* and returns it as a char array.
*
* @param codePoint
* the Unicode code point to encode.
* @return the UTF-16 encoded char sequence. If {@code codePoint} is a
* {@link #isSupplementaryCodePoint(int) supplementary code point},
* then the returned array contains two characters, otherwise it
* contains just one character.
* @throws IllegalArgumentException
* if {@code codePoint} is not a valid Unicode code point.
* @since Android 1.0
*/
public static char[] toChars(int codePoint) {
if (!isValidCodePoint(codePoint)) {
throw new IllegalArgumentException();
}
if (isSupplementaryCodePoint(codePoint)) {
int cpPrime = codePoint - 0x10000;
int high = 0xD800 | ((cpPrime >> 10) & 0x3FF);
int low = 0xDC00 | (cpPrime & 0x3FF);
return new char[] { (char) high, (char) low };
}
return new char[] { (char) codePoint };
}
/**
* Counts the number of Unicode code points in the subsequence of the
* specified character sequence, as delineated by {@code beginIndex} and
* {@code endIndex}. Any surrogate values with missing pair values will be
* counted as one code point.
*
* @param seq
* the {@code CharSequence} to look through.
* @param beginIndex
* the inclusive index to begin counting at.
* @param endIndex
* the exclusive index to stop counting at.
* @return the number of Unicode code points.
* @throws IndexOutOfBoundsException
* if {@code beginIndex < 0}, {@code beginIndex > endIndex} or
* if {@code endIndex} is greater than the length of {@code seq}.
* @since Android 1.0
*/
public static int codePointCount(CharSequence seq, int beginIndex,
int endIndex) {
if (seq == null) {
throw new NullPointerException();
}
int len = seq.length();
if (beginIndex < 0 || endIndex > len || beginIndex > endIndex) {
throw new IndexOutOfBoundsException();
}
int result = 0;
for (int i = beginIndex; i < endIndex; i++) {
char c = seq.charAt(i);
if (isHighSurrogate(c)) {
if (++i < endIndex) {
c = seq.charAt(i);
if (!isLowSurrogate(c)) {
result++;
}
}
}
result++;
}
return result;
}
/**
* Counts the number of Unicode code points in the subsequence of the
* specified char array, as delineated by {@code offset} and {@code count}.
* Any surrogate values with missing pair values will be counted as one code
* point.
*
* @param seq
* the char array to look through
* @param offset
* the inclusive index to begin counting at.
* @param count
* the number of {@code char} values to look through in
* {@code seq}.
* @return the number of Unicode code points.
* @throws IndexOutOfBoundsException
* if {@code offset < 0}, {@code count < 0} or if
* {@code offset + count} is greater than the length of
* {@code seq}.
* @since Android 1.0
*/
public static int codePointCount(char[] seq, int offset, int count) {
if (seq == null) {
throw new NullPointerException();
}
int len = seq.length;
int endIndex = offset + count;
if (offset < 0 || count < 0 || endIndex > len) {
throw new IndexOutOfBoundsException();
}
int result = 0;
for (int i = offset; i < endIndex; i++) {
char c = seq[i];
if (isHighSurrogate(c)) {
if (++i < endIndex) {
c = seq[i];
if (!isLowSurrogate(c)) {
result++;
}
}
}
result++;
}
return result;
}
/**
* Determines the index in the specified character sequence that is offset
* {@code codePointOffset} code points from {@code index}.
*
* @param seq
* the character sequence to find the index in.
* @param index
* the start index in {@code seq}.
* @param codePointOffset
* the number of code points to look backwards or forwards; may
* be a negative or positive value.
* @return the index in {@code seq} that is {@code codePointOffset} code
* points away from {@code index}.
* @throws IndexOutOfBoundsException
* if {@code index < 0}, {@code index} is greater than the
* length of {@code seq}, or if there are not enough values in
* {@code seq} to skip {@code codePointOffset} code points
* forwards or backwards (if {@code codePointOffset} is
* negative) from {@code index}.
* @since Android 1.0
*/
public static int offsetByCodePoints(CharSequence seq, int index,
int codePointOffset) {
if (seq == null) {
throw new NullPointerException();
}
int len = seq.length();
if (index < 0 || index > len) {
throw new IndexOutOfBoundsException();
}
if (codePointOffset == 0) {
return index;
}
if (codePointOffset > 0) {
int codePoints = codePointOffset;
int i = index;
while (codePoints > 0) {
codePoints--;
if (i >= len) {
throw new IndexOutOfBoundsException();
}
if (isHighSurrogate(seq.charAt(i))) {
int next = i + 1;
if (next < len && isLowSurrogate(seq.charAt(next))) {
i++;
}
}
i++;
}
return i;
}
assert codePointOffset < 0;
int codePoints = -codePointOffset;
int i = index;
while (codePoints > 0) {
codePoints--;
i--;
if (i < 0) {
throw new IndexOutOfBoundsException();
}
if (isLowSurrogate(seq.charAt(i))) {
int prev = i - 1;
if (prev >= 0 && isHighSurrogate(seq.charAt(prev))) {
i--;
}
}
}
return i;
}
/**
* Determines the index in a subsequence of the specified character array
* that is offset {@code codePointOffset} code points from {@code index}.
* The subsequence is delineated by {@code start} and {@code count}.
*
* @param seq
* the character array to find the index in.
* @param start
* the inclusive index that marks the beginning of the
* subsequence.
* @param count
* the number of {@code char} values to include within the
* subsequence.
* @param index
* the start index in the subsequence of the char array.
* @param codePointOffset
* the number of code points to look backwards or forwards; may
* be a negative or positive value.
* @return the index in {@code seq} that is {@code codePointOffset} code
* points away from {@code index}.
* @throws IndexOutOfBoundsException
* if {@code start < 0}, {@code count < 0},
* {@code index < start}, {@code index > start + count},
* {@code start + count} is greater than the length of
* {@code seq}, or if there are not enough values in
* {@code seq} to skip {@code codePointOffset} code points
* forward or backward (if {@code codePointOffset} is
* negative) from {@code index}.
* @since Android 1.0
*/
public static int offsetByCodePoints(char[] seq, int start, int count,
int index, int codePointOffset) {
if (seq == null) {
throw new NullPointerException();
}
int end = start + count;
if (start < 0 || count < 0 || end > seq.length || index < start
|| index > end) {
throw new IndexOutOfBoundsException();
}
if (codePointOffset == 0) {
return index;
}
if (codePointOffset > 0) {
int codePoints = codePointOffset;
int i = index;
while (codePoints > 0) {
codePoints--;
if (i >= end) {
throw new IndexOutOfBoundsException();
}
if (isHighSurrogate(seq[i])) {
int next = i + 1;
if (next < end && isLowSurrogate(seq[next])) {
i++;
}
}
i++;
}
return i;
}
assert codePointOffset < 0;
int codePoints = -codePointOffset;
int i = index;
while (codePoints > 0) {
codePoints--;
i--;
if (i < start) {
throw new IndexOutOfBoundsException();
}
if (isLowSurrogate(seq[i])) {
int prev = i - 1;
if (prev >= start && isHighSurrogate(seq[prev])) {
i--;
}
}
}
return i;
}
/**
* Convenience method to determine the value of the specified character
* {@code c} in the supplied radix. The value of {@code radix} must be
* between MIN_RADIX and MAX_RADIX.
*
* @param c
* the character to determine the value of.
* @param radix
* the radix.
* @return the value of {@code c} in {@code radix} if {@code radix} lies
* between {@link #MIN_RADIX} and {@link #MAX_RADIX}; -1 otherwise.
* @since Android 1.0
*/
public static int digit(char c, int radix) {
// BEGIN android-changed
// if (radix >= MIN_RADIX && radix <= MAX_RADIX) {
// if (c < 128) {
// // Optimized for ASCII
// int result = -1;
// if ('0' <= c && c <= '9') {
// result = c - '0';
// } else if ('a' <= c && c <= 'z') {
// result = c - ('a' - 10);
// } else if ('A' <= c && c <= 'Z') {
// result = c - ('A' - 10);
// }
// return result < radix ? result : -1;
// }
// int result = BinarySearch.binarySearchRange(digitKeys, c);
// if (result >= 0 && c <= digitValues[result * 2]) {
// int value = (char) (c - digitValues[result * 2 + 1]);
// if (value >= radix) {
// return -1;
// }
// return value;
// }
// }
// return -1;
return UCharacter.digit(c, radix);
// ENd android-changed
}
/**
* Convenience method to determine the value of the character
* {@code codePoint} in the supplied radix. The value of {@code radix} must
* be between MIN_RADIX and MAX_RADIX.
*
* @param codePoint
* the character, including supplementary characters.
* @param radix
* the radix.
* @return if {@code radix} lies between {@link #MIN_RADIX} and
* {@link #MAX_RADIX} then the value of the character in the radix;
* -1 otherwise.
* @since Android 1.0
*/
public static int digit(int codePoint, int radix) {
return UCharacter.digit(codePoint, radix);
}
/**
* Compares this object with the specified object and indicates if they are
* equal. In order to be equal, {@code object} must be an instance of
* {@code Character} and have the same char value as this object.
*
* @param object
* the object to compare this double with.
* @return {@code true} if the specified object is equal to this
* {@code Character}; {@code false} otherwise.
* @since Android 1.0
*/
@Override
public boolean equals(Object object) {
return (object instanceof Character)
&& (value == ((Character) object).value);
}
/**
* Returns the character which represents the specified digit in the
* specified radix. The {@code radix} must be between {@code MIN_RADIX} and
* {@code MAX_RADIX} inclusive; {@code digit} must not be negative and
* smaller than {@code radix}. If any of these conditions does not hold, 0
* is returned.
*
* @param digit
* the integer value.
* @param radix
* the radix.
* @return the character which represents the {@code digit} in the
* {@code radix}.
* @since Android 1.0
*/
public static char forDigit(int digit, int radix) {
if (MIN_RADIX <= radix && radix <= MAX_RADIX) {
if (0 <= digit && digit < radix) {
return (char) (digit < 10 ? digit + '0' : digit + 'a' - 10);
}
}
return 0;
}
/**
* Gets the numeric value of the specified Unicode character.
*
* @param c
* the Unicode character to get the numeric value of.
* @return a non-negative numeric integer value if a numeric value for
* {@code c} exists, -1 if there is no numeric value for {@code c},
* -2 if the numeric value can not be represented with an integer.
* @since Android 1.0
*/
public static int getNumericValue(char c) {
// BEGIN android-changed
// if (c < 128) {
// // Optimized for ASCII
// if (c >= '0' && c <= '9') {
// return c - '0';
// }
// if (c >= 'a' && c <= 'z') {
// return c - ('a' - 10);
// }
// if (c >= 'A' && c <= 'Z') {
// return c - ('A' - 10);
// }
// return -1;
// }
// int result = BinarySearch.binarySearchRange(numericKeys, c);
// if (result >= 0 && c <= numericValues[result * 2]) {
// char difference = numericValues[result * 2 + 1];
// if (difference == 0) {
// return -2;
// }
// // Value is always positive, must be negative value
// if (difference > c) {
// return c - (short) difference;
// }
// return c - difference;
// }
// return -1;
return UCharacter.getNumericValue(c);
// END android-changed
}
/**
* Gets the numeric value of the specified Unicode code point. For example,
* the code point '\u216B' stands for the Roman number XII, which has the
* numeric value 12.
*
* @param codePoint
* the Unicode code point to get the numeric value of.
* @return a non-negative numeric integer value if a numeric value for
* {@code codePoint} exists, -1 if there is no numeric value for
* {@code codePoint}, -2 if the numeric value can not be
* represented with an integer.
* @since Android 1.0
*/
public static int getNumericValue(int codePoint) {
return UCharacter.getNumericValue(codePoint);
}
/**
* Gets the general Unicode category of the specified character.
*
* @param c
* the character to get the category of.
* @return the Unicode category of {@code c}.
* @since Android 1.0
*/
public static int getType(char c) {
// BEGIN android-changed
// int result = BinarySearch.binarySearchRange(typeKeys, c);
// int high = typeValues[result * 2];
// if (c <= high) {
// int code = typeValues[result * 2 + 1];
// if (code < 0x100) {
// return code;
// }
// return (c & 1) == 1 ? code >> 8 : code & 0xff;
// }
// return UNASSIGNED;
return getType((int)c);
// END android-changed
}
/**
* Gets the general Unicode category of the specified code point.
*
* @param codePoint
* the Unicode code point to get the category of.
* @return the Unicode category of {@code codePoint}.
* @since Android 1.0
*/
public static int getType(int codePoint) {
int type = UCharacter.getType(codePoint);
// the type values returned by UCharacter are not compatible with what
// the spec says.RI's Character type values skip the value 17.
if (type <= Character.FORMAT) {
return type;
}
return (type + 1);
}
/**
* Gets the Unicode directionality of the specified character.
*
* @param c
* the character to get the directionality of.
* @return the Unicode directionality of {@code c}.
* @since Android 1.0
*/
public static byte getDirectionality(char c) {
// BEGIN android-changed
// int result = BinarySearch.binarySearchRange(bidiKeys, c);
// int high = bidiValues[result * 2];
// if (c <= high) {
// int code = bidiValues[result * 2 + 1];
// if (code < 0x100) {
// return (byte) (code - 1);
// }
// return (byte) (((c & 1) == 1 ? code >> 8 : code & 0xff) - 1);
// }
// return DIRECTIONALITY_UNDEFINED;
return getDirectionality((int)c);
// END android-changed
}
/**
* Gets the Unicode directionality of the specified character.
*
* @param codePoint
* the Unicode code point to get the directionality of.
* @return the Unicode directionality of {@code codePoint}.
* @since Android 1.0
*/
public static byte getDirectionality(int codePoint) {
if (getType(codePoint) == Character.UNASSIGNED) {
return Character.DIRECTIONALITY_UNDEFINED;
}
byte UCDirectionality = UCharacter.getDirectionality(codePoint);
if (UCDirectionality == -1) {
return -1;
}
return DIRECTIONALITY[UCDirectionality];
}
/**
* Indicates whether the specified character is mirrored.
*
* @param c
* the character to check.
* @return {@code true} if {@code c} is mirrored; {@code false}
* otherwise.
* @since Android 1.0
*/
public static boolean isMirrored(char c) {
// BEGIN android-changed
// int value = c / 16;
// if (value >= mirrored.length) {
// return false;
// }
// int bit = 1 << (c % 16);
// return (mirrored[value] & bit) != 0;
return isMirrored((int)c);
// ENd android-changed
}
/**
* Indicates whether the specified code point is mirrored.
*
* @param codePoint
* the code point to check.
* @return {@code true} if {@code codePoint} is mirrored, {@code false}
* otherwise.
* @since Android 1.0
*/
public static boolean isMirrored(int codePoint) {
return UCharacter.isMirrored(codePoint);
}
@Override
public int hashCode() {
return value;
}
/**
* Indicates whether the specified character is defined in the Unicode
* specification.
*
* @param c
* the character to check.
* @return {@code true} if the general Unicode category of the character is
* not {@code UNASSIGNED}; {@code false} otherwise.
* @since Android 1.0
*/
public static boolean isDefined(char c) {
// BEGIN android-changed
// return getType(c) != UNASSIGNED;
return UCharacter.isDefined(c);
// END android-changed
}
/**
* Indicates whether the specified code point is defined in the Unicode
* specification.
*
* @param codePoint
* the code point to check.
* @return {@code true} if the general Unicode category of the code point is
* not {@code UNASSIGNED}; {@code false} otherwise.
* @since Android 1.0
*/
public static boolean isDefined(int codePoint) {
return UCharacter.isDefined(codePoint);
}
/**
* Indicates whether the specified character is a digit.
*
* @param c
* the character to check.
* @return {@code true} if {@code c} is a digit; {@code false}
* otherwise.
* @since Android 1.0
*/
public static boolean isDigit(char c) {
// BEGIN android-changed
// // Optimized case for ASCII
// if ('0' <= c && c <= '9') {
// return true;
// }
// if (c < 1632) {
// return false;
// }
// return getType(c) == DECIMAL_DIGIT_NUMBER;
return UCharacter.isDigit(c);
// END android-changed
}
/**
* Indicates whether the specified code point is a digit.
*
* @param codePoint
* the code point to check.
* @return {@code true} if {@code codePoint} is a digit; {@code false}
* otherwise.
* @since Android 1.0
*/
public static boolean isDigit(int codePoint) {
return UCharacter.isDigit(codePoint);
}
/**
* Indicates whether the specified character is ignorable in a Java or
* Unicode identifier.
*
* @param c
* the character to check.
* @return {@code true} if {@code c} is ignorable; {@code false} otherwise.
* @since Android 1.0
*/
public static boolean isIdentifierIgnorable(char c) {
// BEGIN android-changed
// return (c >= 0 && c <= 8) || (c >= 0xe && c <= 0x1b)
// || (c >= 0x7f && c <= 0x9f) || getType(c) == FORMAT;
return UCharacter.isIdentifierIgnorable(c);
// END android-changed
}
/**
* Indicates whether the specified code point is ignorable in a Java or
* Unicode identifier.
*
* @param codePoint
* the code point to check.
* @return {@code true} if {@code codePoint} is ignorable; {@code false}
* otherwise.
* @since Android 1.0
*/
public static boolean isIdentifierIgnorable(int codePoint) {
return UCharacter.isIdentifierIgnorable(codePoint);
}
/**
* Indicates whether the specified character is an ISO control character.
*
* @param c
* the character to check.
* @return {@code true} if {@code c} is an ISO control character;
* {@code false} otherwise.
* @since Android 1.0
*/
public static boolean isISOControl(char c) {
return isISOControl((int)c);
}
/**
* Indicates whether the specified code point is an ISO control character.
*
* @param c
* the code point to check.
* @return {@code true} if {@code c} is an ISO control character;
* {@code false} otherwise.
* @since Android 1.0
*/
public static boolean isISOControl(int c) {
return (c >= 0 && c <= 0x1f) || (c >= 0x7f && c <= 0x9f);
}
/**
* Indicates whether the specified character is a valid part of a Java
* identifier other than the first character.
*
* @param c
* the character to check.
* @return {@code true} if {@code c} is valid as part of a Java identifier;
* {@code false} otherwise.
* @since Android 1.0
*/
public static boolean isJavaIdentifierPart(char c) {
// Optimized case for ASCII
if (c < 128) {
return (typeTags[c] & ISJAVAPART) != 0;
}
int type = getType(c);
return (type >= UPPERCASE_LETTER && type <= OTHER_LETTER)
|| type == CURRENCY_SYMBOL || type == CONNECTOR_PUNCTUATION
|| (type >= DECIMAL_DIGIT_NUMBER && type <= LETTER_NUMBER)
|| type == NON_SPACING_MARK || type == COMBINING_SPACING_MARK
|| (c >= 0x80 && c <= 0x9f) || type == FORMAT;
}
/**
* Indicates whether the specified code point is a valid part of a Java
* identifier other than the first character.
*
* @param codePoint
* the code point to check.
* @return {@code true} if {@code c} is valid as part of a Java identifier;
* {@code false} otherwise.
* @since Android 1.0
*/
public static boolean isJavaIdentifierPart(int codePoint) {
int type = getType(codePoint);
return (type >= UPPERCASE_LETTER && type <= OTHER_LETTER)
|| type == CURRENCY_SYMBOL || type == CONNECTOR_PUNCTUATION
|| (type >= DECIMAL_DIGIT_NUMBER && type <= LETTER_NUMBER)
|| type == COMBINING_SPACING_MARK || type == NON_SPACING_MARK
|| isIdentifierIgnorable(codePoint);
}
/**
* Indicates whether the specified character is a valid first character for
* a Java identifier.
*
* @param c
* the character to check.
* @return {@code true} if {@code c} is a valid first character of a Java
* identifier; {@code false} otherwise.
* @since Android 1.0
*/
public static boolean isJavaIdentifierStart(char c) {
// Optimized case for ASCII
if (c < 128) {
return (typeTags[c] & ISJAVASTART) != 0;
}
int type = getType(c);
return (type >= UPPERCASE_LETTER && type <= OTHER_LETTER)
|| type == CURRENCY_SYMBOL || type == CONNECTOR_PUNCTUATION
|| type == LETTER_NUMBER;
}
/**
* Indicates whether the specified code point is a valid start for a Java
* identifier.
*
* @param codePoint
* the code point to check.
* @return {@code true} if {@code codePoint} is a valid start of a Java
* identifier; {@code false} otherwise.
* @since Android 1.0
*/
public static boolean isJavaIdentifierStart(int codePoint) {
int type = getType(codePoint);
return isLetter(codePoint) || type == CURRENCY_SYMBOL
|| type == CONNECTOR_PUNCTUATION || type == LETTER_NUMBER;
}
/**
* Indicates whether the specified character is a Java letter.
*
* @param c
* the character to check.
* @return {@code true} if {@code c} is a Java letter; {@code false}
* otherwise.
* @deprecated Use {@link #isJavaIdentifierStart(char)}
* @since Android 1.0
*/
@Deprecated
public static boolean isJavaLetter(char c) {
return isJavaIdentifierStart(c);
}
/**
* Indicates whether the specified character is a Java letter or digit
* character.
*
* @param c
* the character to check.
* @return {@code true} if {@code c} is a Java letter or digit;
* {@code false} otherwise.
* @deprecated Use {@link #isJavaIdentifierPart(char)}
* @since Android 1.0
*/
@Deprecated
public static boolean isJavaLetterOrDigit(char c) {
return isJavaIdentifierPart(c);
}
/**
* Indicates whether the specified character is a letter.
*
* @param c
* the character to check.
* @return {@code true} if {@code c} is a letter; {@code false} otherwise.
* @since Android 1.0
*/
public static boolean isLetter(char c) {
// BEGIN android-changed
// if (('A' <= c && c <= 'Z') || ('a' <= c && c <= 'z')) {
// return true;
// }
// if (c < 128) {
// return false;
// }
// int type = getType(c);
// return type >= UPPERCASE_LETTER && type <= OTHER_LETTER;
return UCharacter.isLetter(c);
// END android-changed
}
/**
* Indicates whether the specified code point is a letter.
*
* @param codePoint
* the code point to check.
* @return {@code true} if {@code codePoint} is a letter; {@code false}
* otherwise.
* @since Android 1.0
*/
public static boolean isLetter(int codePoint) {
return UCharacter.isLetter(codePoint);
}
/**
* Indicates whether the specified character is a letter or a digit.
*
* @param c
* the character to check.
* @return {@code true} if {@code c} is a letter or a digit; {@code false}
* otherwise.
* @since Android 1.0
*/
public static boolean isLetterOrDigit(char c) {
// BEGIN android-changed
// int type = getType(c);
// return (type >= UPPERCASE_LETTER && type <= OTHER_LETTER)
// || type == DECIMAL_DIGIT_NUMBER;
return UCharacter.isLetterOrDigit(c);
// END andorid-changed
}
/**
* Indicates whether the specified code point is a letter or a digit.
*
* @param codePoint
* the code point to check.
* @return {@code true} if {@code codePoint} is a letter or a digit;
* {@code false} otherwise.
* @since Android 1.0
*/
public static boolean isLetterOrDigit(int codePoint) {
return UCharacter.isLetterOrDigit(codePoint);
}
/**
* Indicates whether the specified character is a lower case letter.
*
* @param c
* the character to check.
* @return {@code true} if {@code c} is a lower case letter; {@code false}
* otherwise.
* @since Android 1.0
*/
public static boolean isLowerCase(char c) {
// BEGIN android-changed
// // Optimized case for ASCII
// if ('a' <= c && c <= 'z') {
// return true;
// }
// if (c < 128) {
// return false;
// }
//
// return getType(c) == LOWERCASE_LETTER;
return UCharacter.isLowerCase(c);
// END android-changed
}
/**
* Indicates whether the specified code point is a lower case letter.
*
* @param codePoint
* the code point to check.
* @return {@code true} if {@code codePoint} is a lower case letter;
* {@code false} otherwise.
* @since Android 1.0
*/
public static boolean isLowerCase(int codePoint) {
return UCharacter.isLowerCase(codePoint);
}
/**
* Indicates whether the specified character is a Java space.
*
* @param c
* the character to check.
* @return {@code true} if {@code c} is a Java space; {@code false}
* otherwise.
* @deprecated Use {@link #isWhitespace(char)}
* @since Android 1.0
*/
@Deprecated
public static boolean isSpace(char c) {
return c == '\n' || c == '\t' || c == '\f' || c == '\r' || c == ' ';
}
/**
* Indicates whether the specified character is a Unicode space character.
* That is, if it is a member of one of the Unicode categories Space
* Separator, Line Separator, or Paragraph Separator.
*
* @param c
* the character to check.
* @return {@code true} if {@code c} is a Unicode space character,
* {@code false} otherwise.
* @since Android 1.0
*/
public static boolean isSpaceChar(char c) {
// BEGIN android-changed
// if (c == 0x20 || c == 0xa0 || c == 0x1680) {
// return true;
// }
// if (c < 0x2000) {
// return false;
// }
// return c <= 0x200b || c == 0x2028 || c == 0x2029 || c == 0x202f
// || c == 0x3000;
return UCharacter.isSpaceChar(c);
// END android-changed
}
/**
* Indicates whether the specified code point is a Unicode space character.
* That is, if it is a member of one of the Unicode categories Space
* Separator, Line Separator, or Paragraph Separator.
*
* @param codePoint
* the code point to check.
* @return {@code true} if {@code codePoint} is a Unicode space character,
* {@code false} otherwise.
* @since Android 1.0
*/
public static boolean isSpaceChar(int codePoint) {
return UCharacter.isSpaceChar(codePoint);
}
/**
* Indicates whether the specified character is a titlecase character.
*
* @param c
* the character to check.
* @return {@code true} if {@code c} is a titlecase character, {@code false}
* otherwise.
* @since Android 1.0
*/
public static boolean isTitleCase(char c) {
// BEGIN android-changed
// if (c == '\u01c5' || c == '\u01c8' || c == '\u01cb' || c == '\u01f2') {
// return true;
// }
// if (c >= '\u1f88' && c <= '\u1ffc') {
// // 0x1f88 - 0x1f8f, 0x1f98 - 0x1f9f, 0x1fa8 - 0x1faf
// if (c > '\u1faf') {
// return c == '\u1fbc' || c == '\u1fcc' || c == '\u1ffc';
// }
// int last = c & 0xf;
// return last >= 8 && last <= 0xf;
// }
// return false;
return UCharacter.isTitleCase(c);
// END android-changed
}
/**
* Indicates whether the specified code point is a titlecase character.
*
* @param codePoint
* the code point to check.
* @return {@code true} if {@code codePoint} is a titlecase character,
* {@code false} otherwise.
* @since Android 1.0
*/
public static boolean isTitleCase(int codePoint) {
return UCharacter.isTitleCase(codePoint);
}
/**
* Indicates whether the specified character is valid as part of a Unicode
* identifier other than the first character.
*
* @param c
* the character to check.
* @return {@code true} if {@code c} is valid as part of a Unicode
* identifier; {@code false} otherwise.
* @since Android 1.0
*/
public static boolean isUnicodeIdentifierPart(char c) {
// BEGIN android-changed
// int type = getType(c);
// return (type >= UPPERCASE_LETTER && type <= OTHER_LETTER)
// || type == CONNECTOR_PUNCTUATION
// || (type >= DECIMAL_DIGIT_NUMBER && type <= LETTER_NUMBER)
// || type == NON_SPACING_MARK || type == COMBINING_SPACING_MARK
// || isIdentifierIgnorable(c);
return UCharacter.isUnicodeIdentifierPart(c);
// END android-changed
}
/**
* Indicates whether the specified code point is valid as part of a Unicode
* identifier other than the first character.
*
* @param codePoint
* the code point to check.
* @return {@code true} if {@code codePoint} is valid as part of a Unicode
* identifier; {@code false} otherwise.
* @since Android 1.0
*/
public static boolean isUnicodeIdentifierPart(int codePoint) {
return UCharacter.isUnicodeIdentifierPart(codePoint);
}
/**
* Indicates whether the specified character is a valid initial character
* for a Unicode identifier.
*
* @param c
* the character to check.
* @return {@code true} if {@code c} is a valid first character for a
* Unicode identifier; {@code false} otherwise.
* @since Android 1.0
*/
public static boolean isUnicodeIdentifierStart(char c) {
// BEGIN android-changed
// int type = getType(c);
// return (type >= UPPERCASE_LETTER && type <= OTHER_LETTER)
// || type == LETTER_NUMBER;
return UCharacter.isUnicodeIdentifierStart(c);
// END android-changed
}
/**
* Indicates whether the specified code point is a valid initial character
* for a Unicode identifier.
*
* @param codePoint
* the code point to check.
* @return {@code true} if {@code codePoint} is a valid first character for
* a Unicode identifier; {@code false} otherwise.
* @since Android 1.0
*/
public static boolean isUnicodeIdentifierStart(int codePoint) {
return UCharacter.isUnicodeIdentifierStart(codePoint);
}
/**
* Indicates whether the specified character is an upper case letter.
*
* @param c
* the character to check.
* @return {@code true} if {@code c} is a upper case letter; {@code false}
* otherwise.
* @since Android 1.0
*/
public static boolean isUpperCase(char c) {
// BEGIN android-changed
// // Optimized case for ASCII
// if ('A' <= c && c <= 'Z') {
// return true;
// }
// if (c < 128) {
// return false;
// }
//
// return getType(c) == UPPERCASE_LETTER;
return UCharacter.isUpperCase(c);
// END android-changed
}
/**
* Indicates whether the specified code point is an upper case letter.
*
* @param codePoint
* the code point to check.
* @return {@code true} if {@code codePoint} is a upper case letter;
* {@code false} otherwise.
* @since Android 1.0
*/
public static boolean isUpperCase(int codePoint) {
return UCharacter.isUpperCase(codePoint);
}
/**
* Indicates whether the specified character is a whitespace character in
* Java.
*
* @param c
* the character to check.
* @return {@code true} if the supplied {@code c} is a whitespace character
* in Java; {@code false} otherwise.
* @since Android 1.0
*/
public static boolean isWhitespace(char c) {
// BEGIN android-changed
// // Optimized case for ASCII
// if ((c >= 0x1c && c <= 0x20) || (c >= 0x9 && c <= 0xd)) {
// return true;
// }
// if (c == 0x1680) {
// return true;
// }
// if (c < 0x2000 || c == 0x2007) {
// return false;
// }
// return c <= 0x200b || c == 0x2028 || c == 0x2029 || c == 0x3000;
return UCharacter.isWhitespace(c);
// END android-changed
}
/**
* Indicates whether the specified code point is a whitespace character in
* Java.
*
* @param codePoint
* the code point to check.
* @return {@code true} if the supplied {@code c} is a whitespace character
* in Java; {@code false} otherwise.
* @since Android 1.0
*/
public static boolean isWhitespace(int codePoint) {
//FIXME depends on ICU when the codePoint is '\u2007'
return UCharacter.isWhitespace(codePoint);
}
/**
* Reverses the order of the first and second byte in the specified
* character.
*
* @param c
* the character to reverse.
* @return the character with reordered bytes.
* @since Android 1.0
*/
public static char reverseBytes(char c) {
return (char)((c<<8) | (c>>8));
}
/**
* Returns the lower case equivalent for the specified character if the
* character is an upper case letter. Otherwise, the specified character is
* returned unchanged.
*
* @param c
* the character
* @return if {@code c} is an upper case character then its lower case
* counterpart, otherwise just {@code c}.
* @since Android 1.0
*/
public static char toLowerCase(char c) {
// BEGIN android-changed
// // Optimized case for ASCII
// if ('A' <= c && c <= 'Z') {
// return (char) (c + ('a' - 'A'));
// }
// if (c < 128) {
// return c;
// }
//
// int result = BinarySearch.binarySearchRange(lowercaseKeys, c);
// if (result >= 0) {
// boolean by2 = false;
// char start = lowercaseKeys.charAt(result);
// char end = lowercaseValues[result * 2];
// if ((start & 0x8000) != (end & 0x8000)) {
// end ^= 0x8000;
// by2 = true;
// }
// if (c <= end) {
// if (by2 && (c & 1) != (start & 1)) {
// return c;
// }
// char mapping = lowercaseValues[result * 2 + 1];
// return (char) (c + mapping);
// }
// }
// return c;
return (char)UCharacter.toLowerCase(c);
// END android-changed
}
/**
* Returns the lower case equivalent for the specified code point if it is
* an upper case letter. Otherwise, the specified code point is returned
* unchanged.
*
* @param codePoint
* the code point to check.
* @return if {@code codePoint} is an upper case character then its lower
* case counterpart, otherwise just {@code codePoint}.
* @since Android 1.0
*/
public static int toLowerCase(int codePoint) {
return UCharacter.toLowerCase(codePoint);
}
@Override
public String toString() {
return String.valueOf(value);
}
/**
* Converts the specified character to its string representation.
*
* @param value
* the character to convert.
* @return the character converted to a string.
* @since Android 1.0
*/
public static String toString(char value) {
return String.valueOf(value);
}
/**
* Returns the title case equivalent for the specified character if it
* exists. Otherwise, the specified character is returned unchanged.
*
* @param c
* the character to convert.
* @return the title case equivalent of {@code c} if it exists, otherwise
* {@code c}.
* @since Android 1.0
*/
public static char toTitleCase(char c) {
// BEGIN android-changed
// if (isTitleCase(c)) {
// return c;
// }
// int result = BinarySearch.binarySearch(titlecaseKeys, c);
// if (result >= 0) {
// return titlecaseValues[result];
// }
// return toUpperCase(c);
return (char)UCharacter.toTitleCase(c);
// ENd android-changed
}
/**
* Returns the title case equivalent for the specified code point if it
* exists. Otherwise, the specified code point is returned unchanged.
*
* @param codePoint
* the code point to convert.
* @return the title case equivalent of {@code codePoint} if it exists,
* otherwise {@code codePoint}.
* @since Android 1.0
*/
public static int toTitleCase(int codePoint) {
return UCharacter.toTitleCase(codePoint);
}
/**
* Returns the upper case equivalent for the specified character if the
* character is a lower case letter. Otherwise, the specified character is
* returned unchanged.
*
* @param c
* the character to convert.
* @return if {@code c} is a lower case character then its upper case
* counterpart, otherwise just {@code c}.
* @since Android 1.0
*/
public static char toUpperCase(char c) {
// BEGIN android-changed
// // Optimized case for ASCII
// if ('a' <= c && c <= 'z') {
// return (char) (c - ('a' - 'A'));
// }
// if (c < 128) {
// return c;
// }
//
// int result = BinarySearch.binarySearchRange(uppercaseKeys, c);
// if (result >= 0) {
// boolean by2 = false;
// char start = uppercaseKeys.charAt(result);
// char end = uppercaseValues[result * 2];
// if ((start & 0x8000) != (end & 0x8000)) {
// end ^= 0x8000;
// by2 = true;
// }
// if (c <= end) {
// if (by2 && (c & 1) != (start & 1)) {
// return c;
// }
// char mapping = uppercaseValues[result * 2 + 1];
// return (char) (c + mapping);
// }
// }
// return c;
return (char)UCharacter.toUpperCase(c);
// END android-changed
}
/**
* Returns the upper case equivalent for the specified code point if the
* code point is a lower case letter. Otherwise, the specified code point is
* returned unchanged.
*
* @param codePoint
* the code point to convert.
* @return if {@code codePoint} is a lower case character then its upper
* case counterpart, otherwise just {@code codePoint}.
* @since Android 1.0
*/
public static int toUpperCase(int codePoint) {
return UCharacter.toUpperCase(codePoint);
}
}
|
