mirror of
https://github.com/autc04/Retro68.git
synced 2024-09-10 03:54:48 +00:00
4052 lines
122 KiB
Java
4052 lines
122 KiB
Java
/* java.lang.Character -- Wrapper class for char, and Unicode subsets
|
|
Copyright (C) 1998, 1999, 2001, 2002, 2005, 2006, 2007
|
|
Free Software Foundation, Inc.
|
|
|
|
This file is part of GNU Classpath.
|
|
|
|
GNU Classpath is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation; either version 2, or (at your option)
|
|
any later version.
|
|
|
|
GNU Classpath is distributed in the hope that it will be useful, but
|
|
WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with GNU Classpath; see the file COPYING. If not, write to the
|
|
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
|
|
02110-1301 USA.
|
|
|
|
Linking this library statically or dynamically with other modules is
|
|
making a combined work based on this library. Thus, the terms and
|
|
conditions of the GNU General Public License cover the whole
|
|
combination.
|
|
|
|
As a special exception, the copyright holders of this library give you
|
|
permission to link this library with independent modules to produce an
|
|
executable, regardless of the license terms of these independent
|
|
modules, and to copy and distribute the resulting executable under
|
|
terms of your choice, provided that you also meet, for each linked
|
|
independent module, the terms and conditions of the license of that
|
|
module. An independent module is a module which is not derived from
|
|
or based on this library. If you modify this library, you may extend
|
|
this exception to your version of the library, but you are not
|
|
obligated to do so. If you do not wish to do so, delete this
|
|
exception statement from your version. */
|
|
|
|
/*
|
|
* Note: This class must not be merged with Classpath. Gcj uses C-style
|
|
* arrays (see include/java-chartables.h) to store the Unicode character
|
|
* database, whereas Classpath uses Java objects (char[] extracted from
|
|
* String constants) in gnu.java.lang.CharData. Gcj's approach is more
|
|
* efficient, because there is no vtable or data relocation to worry about.
|
|
* However, despite the difference in the database interface, the two
|
|
* versions share identical algorithms.
|
|
*/
|
|
|
|
package java.lang;
|
|
|
|
import java.io.Serializable;
|
|
import java.text.Collator;
|
|
import java.util.Locale;
|
|
|
|
/**
|
|
* Wrapper class for the primitive char data type. In addition, this class
|
|
* allows one to retrieve property information and perform transformations
|
|
* on the defined characters in the Unicode Standard, Version 4.0.0.
|
|
* java.lang.Character is designed to be very dynamic, and as such, it
|
|
* retrieves information on the Unicode character set from a separate
|
|
* database, gnu.java.lang.CharData, which can be easily upgraded.
|
|
*
|
|
* <p>For predicates, boundaries are used to describe
|
|
* the set of characters for which the method will return true.
|
|
* This syntax uses fairly normal regular expression notation.
|
|
* See 5.13 of the Unicode Standard, Version 4.0, for the
|
|
* boundary specification.
|
|
*
|
|
* <p>See <a href="http://www.unicode.org">http://www.unicode.org</a>
|
|
* for more information on the Unicode Standard.
|
|
*
|
|
* @author Tom Tromey (tromey@cygnus.com)
|
|
* @author Paul N. Fisher
|
|
* @author Jochen Hoenicke
|
|
* @author Eric Blake (ebb9@email.byu.edu)
|
|
* @author Andrew John Hughes (gnu_andrew@member.fsf.org)
|
|
* @since 1.0
|
|
* @status partly updated to 1.5; some things still missing
|
|
*/
|
|
public final class Character implements Serializable, Comparable<Character>
|
|
{
|
|
/**
|
|
* A subset of Unicode blocks.
|
|
*
|
|
* @author Paul N. Fisher
|
|
* @author Eric Blake (ebb9@email.byu.edu)
|
|
* @since 1.2
|
|
*/
|
|
public static class Subset
|
|
{
|
|
/** The name of the subset. */
|
|
private final String name;
|
|
|
|
/**
|
|
* Construct a new subset of characters.
|
|
*
|
|
* @param name the name of the subset
|
|
* @throws NullPointerException if name is null
|
|
*/
|
|
protected Subset(String name)
|
|
{
|
|
// Note that name.toString() is name, unless name was null.
|
|
this.name = name.toString();
|
|
}
|
|
|
|
/**
|
|
* Compares two Subsets for equality. This is <code>final</code>, and
|
|
* restricts the comparison on the <code>==</code> operator, so it returns
|
|
* true only for the same object.
|
|
*
|
|
* @param o the object to compare
|
|
* @return true if o is this
|
|
*/
|
|
public final boolean equals(Object o)
|
|
{
|
|
return o == this;
|
|
}
|
|
|
|
/**
|
|
* Makes the original hashCode of Object final, to be consistent with
|
|
* equals.
|
|
*
|
|
* @return the hash code for this object
|
|
*/
|
|
public final int hashCode()
|
|
{
|
|
return super.hashCode();
|
|
}
|
|
|
|
/**
|
|
* Returns the name of the subset.
|
|
*
|
|
* @return the name
|
|
*/
|
|
public final String toString()
|
|
{
|
|
return name;
|
|
}
|
|
} // class Subset
|
|
|
|
/**
|
|
* A family of character subsets in the Unicode specification. A character
|
|
* is in at most one of these blocks.
|
|
*
|
|
* This inner class was generated automatically from
|
|
* <code>libjava/gnu/gcj/convert/Blocks-3.txt</code>, by some perl scripts.
|
|
* This Unicode definition file can be found on the
|
|
* <a href="http://www.unicode.org">http://www.unicode.org</a> website.
|
|
* JDK 1.4 uses Unicode version 3.0.0.
|
|
*
|
|
* @author scripts/unicode-blocks.pl (written by Eric Blake)
|
|
* @since 1.2
|
|
*/
|
|
public static final class UnicodeBlock extends Subset
|
|
{
|
|
/** The start of the subset. */
|
|
private final int start;
|
|
|
|
/** The end of the subset. */
|
|
private final int end;
|
|
|
|
/** The canonical name of the block according to the Unicode standard. */
|
|
private final String canonicalName;
|
|
|
|
/** Enumeration for the <code>forName()</code> method */
|
|
private enum NameType { CANONICAL, NO_SPACES, CONSTANT; }
|
|
|
|
/**
|
|
* Constructor for strictly defined blocks.
|
|
*
|
|
* @param start the start character of the range
|
|
* @param end the end character of the range
|
|
* @param name the block name
|
|
*/
|
|
private UnicodeBlock(int start, int end, String name,
|
|
String canonicalName)
|
|
{
|
|
super(name);
|
|
this.start = start;
|
|
this.end = end;
|
|
this.canonicalName = canonicalName;
|
|
}
|
|
|
|
/**
|
|
* Returns the Unicode character block which a character belongs to.
|
|
* <strong>Note</strong>: This method does not support the use of
|
|
* supplementary characters. For such support, <code>of(int)</code>
|
|
* should be used instead.
|
|
*
|
|
* @param ch the character to look up
|
|
* @return the set it belongs to, or null if it is not in one
|
|
*/
|
|
public static UnicodeBlock of(char ch)
|
|
{
|
|
return of((int) ch);
|
|
}
|
|
|
|
/**
|
|
* Returns the Unicode character block which a code point belongs to.
|
|
*
|
|
* @param codePoint the character to look up
|
|
* @return the set it belongs to, or null if it is not in one.
|
|
* @throws IllegalArgumentException if the specified code point is
|
|
* invalid.
|
|
* @since 1.5
|
|
*/
|
|
public static UnicodeBlock of(int codePoint)
|
|
{
|
|
if (codePoint > MAX_CODE_POINT)
|
|
throw new IllegalArgumentException("The supplied integer value is " +
|
|
"too large to be a codepoint.");
|
|
// Simple binary search for the correct block.
|
|
int low = 0;
|
|
int hi = sets.length - 1;
|
|
while (low <= hi)
|
|
{
|
|
int mid = (low + hi) >> 1;
|
|
UnicodeBlock b = sets[mid];
|
|
if (codePoint < b.start)
|
|
hi = mid - 1;
|
|
else if (codePoint > b.end)
|
|
low = mid + 1;
|
|
else
|
|
return b;
|
|
}
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* <p>
|
|
* Returns the <code>UnicodeBlock</code> with the given name, as defined
|
|
* by the Unicode standard. The version of Unicode in use is defined by
|
|
* the <code>Character</code> class, and the names are given in the
|
|
* <code>Blocks-<version>.txt</code> file corresponding to that version.
|
|
* The name may be specified in one of three ways:
|
|
* </p>
|
|
* <ol>
|
|
* <li>The canonical, human-readable name used by the Unicode standard.
|
|
* This is the name with all spaces and hyphens retained. For example,
|
|
* `Basic Latin' retrieves the block, UnicodeBlock.BASIC_LATIN.</li>
|
|
* <li>The canonical name with all spaces removed e.g. `BasicLatin'.</li>
|
|
* <li>The name used for the constants specified by this class, which
|
|
* is the canonical name with all spaces and hyphens replaced with
|
|
* underscores e.g. `BASIC_LATIN'</li>
|
|
* </ol>
|
|
* <p>
|
|
* The names are compared case-insensitively using the case comparison
|
|
* associated with the U.S. English locale. The method recognises the
|
|
* previous names used for blocks as well as the current ones. At
|
|
* present, this simply means that the deprecated `SURROGATES_AREA'
|
|
* will be recognised by this method (the <code>of()</code> methods
|
|
* only return one of the three new surrogate blocks).
|
|
* </p>
|
|
*
|
|
* @param blockName the name of the block to look up.
|
|
* @return the specified block.
|
|
* @throws NullPointerException if the <code>blockName</code> is
|
|
* <code>null</code>.
|
|
* @throws IllegalArgumentException if the name does not match any Unicode
|
|
* block.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock forName(String blockName)
|
|
{
|
|
NameType type;
|
|
if (blockName.indexOf(' ') != -1)
|
|
type = NameType.CANONICAL;
|
|
else if (blockName.indexOf('_') != -1)
|
|
type = NameType.CONSTANT;
|
|
else
|
|
type = NameType.NO_SPACES;
|
|
Collator usCollator = Collator.getInstance(Locale.US);
|
|
usCollator.setStrength(Collator.PRIMARY);
|
|
/* Special case for deprecated blocks not in sets */
|
|
switch (type)
|
|
{
|
|
case CANONICAL:
|
|
if (usCollator.compare(blockName, "Surrogates Area") == 0)
|
|
return SURROGATES_AREA;
|
|
break;
|
|
case NO_SPACES:
|
|
if (usCollator.compare(blockName, "SurrogatesArea") == 0)
|
|
return SURROGATES_AREA;
|
|
break;
|
|
case CONSTANT:
|
|
if (usCollator.compare(blockName, "SURROGATES_AREA") == 0)
|
|
return SURROGATES_AREA;
|
|
break;
|
|
}
|
|
/* Other cases */
|
|
switch (type)
|
|
{
|
|
case CANONICAL:
|
|
for (UnicodeBlock block : sets)
|
|
if (usCollator.compare(blockName, block.canonicalName) == 0)
|
|
return block;
|
|
break;
|
|
case NO_SPACES:
|
|
for (UnicodeBlock block : sets)
|
|
{
|
|
String nsName = block.canonicalName.replaceAll(" ","");
|
|
if (usCollator.compare(blockName, nsName) == 0)
|
|
return block;
|
|
}
|
|
break;
|
|
case CONSTANT:
|
|
for (UnicodeBlock block : sets)
|
|
if (usCollator.compare(blockName, block.toString()) == 0)
|
|
return block;
|
|
break;
|
|
}
|
|
throw new IllegalArgumentException("No Unicode block found for " +
|
|
blockName + ".");
|
|
}
|
|
|
|
/**
|
|
* Basic Latin.
|
|
* 0x0000 - 0x007F.
|
|
*/
|
|
public static final UnicodeBlock BASIC_LATIN
|
|
= new UnicodeBlock(0x0000, 0x007F,
|
|
"BASIC_LATIN",
|
|
"Basic Latin");
|
|
|
|
/**
|
|
* Latin-1 Supplement.
|
|
* 0x0080 - 0x00FF.
|
|
*/
|
|
public static final UnicodeBlock LATIN_1_SUPPLEMENT
|
|
= new UnicodeBlock(0x0080, 0x00FF,
|
|
"LATIN_1_SUPPLEMENT",
|
|
"Latin-1 Supplement");
|
|
|
|
/**
|
|
* Latin Extended-A.
|
|
* 0x0100 - 0x017F.
|
|
*/
|
|
public static final UnicodeBlock LATIN_EXTENDED_A
|
|
= new UnicodeBlock(0x0100, 0x017F,
|
|
"LATIN_EXTENDED_A",
|
|
"Latin Extended-A");
|
|
|
|
/**
|
|
* Latin Extended-B.
|
|
* 0x0180 - 0x024F.
|
|
*/
|
|
public static final UnicodeBlock LATIN_EXTENDED_B
|
|
= new UnicodeBlock(0x0180, 0x024F,
|
|
"LATIN_EXTENDED_B",
|
|
"Latin Extended-B");
|
|
|
|
/**
|
|
* IPA Extensions.
|
|
* 0x0250 - 0x02AF.
|
|
*/
|
|
public static final UnicodeBlock IPA_EXTENSIONS
|
|
= new UnicodeBlock(0x0250, 0x02AF,
|
|
"IPA_EXTENSIONS",
|
|
"IPA Extensions");
|
|
|
|
/**
|
|
* Spacing Modifier Letters.
|
|
* 0x02B0 - 0x02FF.
|
|
*/
|
|
public static final UnicodeBlock SPACING_MODIFIER_LETTERS
|
|
= new UnicodeBlock(0x02B0, 0x02FF,
|
|
"SPACING_MODIFIER_LETTERS",
|
|
"Spacing Modifier Letters");
|
|
|
|
/**
|
|
* Combining Diacritical Marks.
|
|
* 0x0300 - 0x036F.
|
|
*/
|
|
public static final UnicodeBlock COMBINING_DIACRITICAL_MARKS
|
|
= new UnicodeBlock(0x0300, 0x036F,
|
|
"COMBINING_DIACRITICAL_MARKS",
|
|
"Combining Diacritical Marks");
|
|
|
|
/**
|
|
* Greek.
|
|
* 0x0370 - 0x03FF.
|
|
*/
|
|
public static final UnicodeBlock GREEK
|
|
= new UnicodeBlock(0x0370, 0x03FF,
|
|
"GREEK",
|
|
"Greek");
|
|
|
|
/**
|
|
* Cyrillic.
|
|
* 0x0400 - 0x04FF.
|
|
*/
|
|
public static final UnicodeBlock CYRILLIC
|
|
= new UnicodeBlock(0x0400, 0x04FF,
|
|
"CYRILLIC",
|
|
"Cyrillic");
|
|
|
|
/**
|
|
* Cyrillic Supplementary.
|
|
* 0x0500 - 0x052F.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock CYRILLIC_SUPPLEMENTARY
|
|
= new UnicodeBlock(0x0500, 0x052F,
|
|
"CYRILLIC_SUPPLEMENTARY",
|
|
"Cyrillic Supplementary");
|
|
|
|
/**
|
|
* Armenian.
|
|
* 0x0530 - 0x058F.
|
|
*/
|
|
public static final UnicodeBlock ARMENIAN
|
|
= new UnicodeBlock(0x0530, 0x058F,
|
|
"ARMENIAN",
|
|
"Armenian");
|
|
|
|
/**
|
|
* Hebrew.
|
|
* 0x0590 - 0x05FF.
|
|
*/
|
|
public static final UnicodeBlock HEBREW
|
|
= new UnicodeBlock(0x0590, 0x05FF,
|
|
"HEBREW",
|
|
"Hebrew");
|
|
|
|
/**
|
|
* Arabic.
|
|
* 0x0600 - 0x06FF.
|
|
*/
|
|
public static final UnicodeBlock ARABIC
|
|
= new UnicodeBlock(0x0600, 0x06FF,
|
|
"ARABIC",
|
|
"Arabic");
|
|
|
|
/**
|
|
* Syriac.
|
|
* 0x0700 - 0x074F.
|
|
* @since 1.4
|
|
*/
|
|
public static final UnicodeBlock SYRIAC
|
|
= new UnicodeBlock(0x0700, 0x074F,
|
|
"SYRIAC",
|
|
"Syriac");
|
|
|
|
/**
|
|
* Thaana.
|
|
* 0x0780 - 0x07BF.
|
|
* @since 1.4
|
|
*/
|
|
public static final UnicodeBlock THAANA
|
|
= new UnicodeBlock(0x0780, 0x07BF,
|
|
"THAANA",
|
|
"Thaana");
|
|
|
|
/**
|
|
* Devanagari.
|
|
* 0x0900 - 0x097F.
|
|
*/
|
|
public static final UnicodeBlock DEVANAGARI
|
|
= new UnicodeBlock(0x0900, 0x097F,
|
|
"DEVANAGARI",
|
|
"Devanagari");
|
|
|
|
/**
|
|
* Bengali.
|
|
* 0x0980 - 0x09FF.
|
|
*/
|
|
public static final UnicodeBlock BENGALI
|
|
= new UnicodeBlock(0x0980, 0x09FF,
|
|
"BENGALI",
|
|
"Bengali");
|
|
|
|
/**
|
|
* Gurmukhi.
|
|
* 0x0A00 - 0x0A7F.
|
|
*/
|
|
public static final UnicodeBlock GURMUKHI
|
|
= new UnicodeBlock(0x0A00, 0x0A7F,
|
|
"GURMUKHI",
|
|
"Gurmukhi");
|
|
|
|
/**
|
|
* Gujarati.
|
|
* 0x0A80 - 0x0AFF.
|
|
*/
|
|
public static final UnicodeBlock GUJARATI
|
|
= new UnicodeBlock(0x0A80, 0x0AFF,
|
|
"GUJARATI",
|
|
"Gujarati");
|
|
|
|
/**
|
|
* Oriya.
|
|
* 0x0B00 - 0x0B7F.
|
|
*/
|
|
public static final UnicodeBlock ORIYA
|
|
= new UnicodeBlock(0x0B00, 0x0B7F,
|
|
"ORIYA",
|
|
"Oriya");
|
|
|
|
/**
|
|
* Tamil.
|
|
* 0x0B80 - 0x0BFF.
|
|
*/
|
|
public static final UnicodeBlock TAMIL
|
|
= new UnicodeBlock(0x0B80, 0x0BFF,
|
|
"TAMIL",
|
|
"Tamil");
|
|
|
|
/**
|
|
* Telugu.
|
|
* 0x0C00 - 0x0C7F.
|
|
*/
|
|
public static final UnicodeBlock TELUGU
|
|
= new UnicodeBlock(0x0C00, 0x0C7F,
|
|
"TELUGU",
|
|
"Telugu");
|
|
|
|
/**
|
|
* Kannada.
|
|
* 0x0C80 - 0x0CFF.
|
|
*/
|
|
public static final UnicodeBlock KANNADA
|
|
= new UnicodeBlock(0x0C80, 0x0CFF,
|
|
"KANNADA",
|
|
"Kannada");
|
|
|
|
/**
|
|
* Malayalam.
|
|
* 0x0D00 - 0x0D7F.
|
|
*/
|
|
public static final UnicodeBlock MALAYALAM
|
|
= new UnicodeBlock(0x0D00, 0x0D7F,
|
|
"MALAYALAM",
|
|
"Malayalam");
|
|
|
|
/**
|
|
* Sinhala.
|
|
* 0x0D80 - 0x0DFF.
|
|
* @since 1.4
|
|
*/
|
|
public static final UnicodeBlock SINHALA
|
|
= new UnicodeBlock(0x0D80, 0x0DFF,
|
|
"SINHALA",
|
|
"Sinhala");
|
|
|
|
/**
|
|
* Thai.
|
|
* 0x0E00 - 0x0E7F.
|
|
*/
|
|
public static final UnicodeBlock THAI
|
|
= new UnicodeBlock(0x0E00, 0x0E7F,
|
|
"THAI",
|
|
"Thai");
|
|
|
|
/**
|
|
* Lao.
|
|
* 0x0E80 - 0x0EFF.
|
|
*/
|
|
public static final UnicodeBlock LAO
|
|
= new UnicodeBlock(0x0E80, 0x0EFF,
|
|
"LAO",
|
|
"Lao");
|
|
|
|
/**
|
|
* Tibetan.
|
|
* 0x0F00 - 0x0FFF.
|
|
*/
|
|
public static final UnicodeBlock TIBETAN
|
|
= new UnicodeBlock(0x0F00, 0x0FFF,
|
|
"TIBETAN",
|
|
"Tibetan");
|
|
|
|
/**
|
|
* Myanmar.
|
|
* 0x1000 - 0x109F.
|
|
* @since 1.4
|
|
*/
|
|
public static final UnicodeBlock MYANMAR
|
|
= new UnicodeBlock(0x1000, 0x109F,
|
|
"MYANMAR",
|
|
"Myanmar");
|
|
|
|
/**
|
|
* Georgian.
|
|
* 0x10A0 - 0x10FF.
|
|
*/
|
|
public static final UnicodeBlock GEORGIAN
|
|
= new UnicodeBlock(0x10A0, 0x10FF,
|
|
"GEORGIAN",
|
|
"Georgian");
|
|
|
|
/**
|
|
* Hangul Jamo.
|
|
* 0x1100 - 0x11FF.
|
|
*/
|
|
public static final UnicodeBlock HANGUL_JAMO
|
|
= new UnicodeBlock(0x1100, 0x11FF,
|
|
"HANGUL_JAMO",
|
|
"Hangul Jamo");
|
|
|
|
/**
|
|
* Ethiopic.
|
|
* 0x1200 - 0x137F.
|
|
* @since 1.4
|
|
*/
|
|
public static final UnicodeBlock ETHIOPIC
|
|
= new UnicodeBlock(0x1200, 0x137F,
|
|
"ETHIOPIC",
|
|
"Ethiopic");
|
|
|
|
/**
|
|
* Cherokee.
|
|
* 0x13A0 - 0x13FF.
|
|
* @since 1.4
|
|
*/
|
|
public static final UnicodeBlock CHEROKEE
|
|
= new UnicodeBlock(0x13A0, 0x13FF,
|
|
"CHEROKEE",
|
|
"Cherokee");
|
|
|
|
/**
|
|
* Unified Canadian Aboriginal Syllabics.
|
|
* 0x1400 - 0x167F.
|
|
* @since 1.4
|
|
*/
|
|
public static final UnicodeBlock UNIFIED_CANADIAN_ABORIGINAL_SYLLABICS
|
|
= new UnicodeBlock(0x1400, 0x167F,
|
|
"UNIFIED_CANADIAN_ABORIGINAL_SYLLABICS",
|
|
"Unified Canadian Aboriginal Syllabics");
|
|
|
|
/**
|
|
* Ogham.
|
|
* 0x1680 - 0x169F.
|
|
* @since 1.4
|
|
*/
|
|
public static final UnicodeBlock OGHAM
|
|
= new UnicodeBlock(0x1680, 0x169F,
|
|
"OGHAM",
|
|
"Ogham");
|
|
|
|
/**
|
|
* Runic.
|
|
* 0x16A0 - 0x16FF.
|
|
* @since 1.4
|
|
*/
|
|
public static final UnicodeBlock RUNIC
|
|
= new UnicodeBlock(0x16A0, 0x16FF,
|
|
"RUNIC",
|
|
"Runic");
|
|
|
|
/**
|
|
* Tagalog.
|
|
* 0x1700 - 0x171F.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock TAGALOG
|
|
= new UnicodeBlock(0x1700, 0x171F,
|
|
"TAGALOG",
|
|
"Tagalog");
|
|
|
|
/**
|
|
* Hanunoo.
|
|
* 0x1720 - 0x173F.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock HANUNOO
|
|
= new UnicodeBlock(0x1720, 0x173F,
|
|
"HANUNOO",
|
|
"Hanunoo");
|
|
|
|
/**
|
|
* Buhid.
|
|
* 0x1740 - 0x175F.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock BUHID
|
|
= new UnicodeBlock(0x1740, 0x175F,
|
|
"BUHID",
|
|
"Buhid");
|
|
|
|
/**
|
|
* Tagbanwa.
|
|
* 0x1760 - 0x177F.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock TAGBANWA
|
|
= new UnicodeBlock(0x1760, 0x177F,
|
|
"TAGBANWA",
|
|
"Tagbanwa");
|
|
|
|
/**
|
|
* Khmer.
|
|
* 0x1780 - 0x17FF.
|
|
* @since 1.4
|
|
*/
|
|
public static final UnicodeBlock KHMER
|
|
= new UnicodeBlock(0x1780, 0x17FF,
|
|
"KHMER",
|
|
"Khmer");
|
|
|
|
/**
|
|
* Mongolian.
|
|
* 0x1800 - 0x18AF.
|
|
* @since 1.4
|
|
*/
|
|
public static final UnicodeBlock MONGOLIAN
|
|
= new UnicodeBlock(0x1800, 0x18AF,
|
|
"MONGOLIAN",
|
|
"Mongolian");
|
|
|
|
/**
|
|
* Limbu.
|
|
* 0x1900 - 0x194F.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock LIMBU
|
|
= new UnicodeBlock(0x1900, 0x194F,
|
|
"LIMBU",
|
|
"Limbu");
|
|
|
|
/**
|
|
* Tai Le.
|
|
* 0x1950 - 0x197F.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock TAI_LE
|
|
= new UnicodeBlock(0x1950, 0x197F,
|
|
"TAI_LE",
|
|
"Tai Le");
|
|
|
|
/**
|
|
* Khmer Symbols.
|
|
* 0x19E0 - 0x19FF.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock KHMER_SYMBOLS
|
|
= new UnicodeBlock(0x19E0, 0x19FF,
|
|
"KHMER_SYMBOLS",
|
|
"Khmer Symbols");
|
|
|
|
/**
|
|
* Phonetic Extensions.
|
|
* 0x1D00 - 0x1D7F.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock PHONETIC_EXTENSIONS
|
|
= new UnicodeBlock(0x1D00, 0x1D7F,
|
|
"PHONETIC_EXTENSIONS",
|
|
"Phonetic Extensions");
|
|
|
|
/**
|
|
* Latin Extended Additional.
|
|
* 0x1E00 - 0x1EFF.
|
|
*/
|
|
public static final UnicodeBlock LATIN_EXTENDED_ADDITIONAL
|
|
= new UnicodeBlock(0x1E00, 0x1EFF,
|
|
"LATIN_EXTENDED_ADDITIONAL",
|
|
"Latin Extended Additional");
|
|
|
|
/**
|
|
* Greek Extended.
|
|
* 0x1F00 - 0x1FFF.
|
|
*/
|
|
public static final UnicodeBlock GREEK_EXTENDED
|
|
= new UnicodeBlock(0x1F00, 0x1FFF,
|
|
"GREEK_EXTENDED",
|
|
"Greek Extended");
|
|
|
|
/**
|
|
* General Punctuation.
|
|
* 0x2000 - 0x206F.
|
|
*/
|
|
public static final UnicodeBlock GENERAL_PUNCTUATION
|
|
= new UnicodeBlock(0x2000, 0x206F,
|
|
"GENERAL_PUNCTUATION",
|
|
"General Punctuation");
|
|
|
|
/**
|
|
* Superscripts and Subscripts.
|
|
* 0x2070 - 0x209F.
|
|
*/
|
|
public static final UnicodeBlock SUPERSCRIPTS_AND_SUBSCRIPTS
|
|
= new UnicodeBlock(0x2070, 0x209F,
|
|
"SUPERSCRIPTS_AND_SUBSCRIPTS",
|
|
"Superscripts and Subscripts");
|
|
|
|
/**
|
|
* Currency Symbols.
|
|
* 0x20A0 - 0x20CF.
|
|
*/
|
|
public static final UnicodeBlock CURRENCY_SYMBOLS
|
|
= new UnicodeBlock(0x20A0, 0x20CF,
|
|
"CURRENCY_SYMBOLS",
|
|
"Currency Symbols");
|
|
|
|
/**
|
|
* Combining Marks for Symbols.
|
|
* 0x20D0 - 0x20FF.
|
|
*/
|
|
public static final UnicodeBlock COMBINING_MARKS_FOR_SYMBOLS
|
|
= new UnicodeBlock(0x20D0, 0x20FF,
|
|
"COMBINING_MARKS_FOR_SYMBOLS",
|
|
"Combining Marks for Symbols");
|
|
|
|
/**
|
|
* Letterlike Symbols.
|
|
* 0x2100 - 0x214F.
|
|
*/
|
|
public static final UnicodeBlock LETTERLIKE_SYMBOLS
|
|
= new UnicodeBlock(0x2100, 0x214F,
|
|
"LETTERLIKE_SYMBOLS",
|
|
"Letterlike Symbols");
|
|
|
|
/**
|
|
* Number Forms.
|
|
* 0x2150 - 0x218F.
|
|
*/
|
|
public static final UnicodeBlock NUMBER_FORMS
|
|
= new UnicodeBlock(0x2150, 0x218F,
|
|
"NUMBER_FORMS",
|
|
"Number Forms");
|
|
|
|
/**
|
|
* Arrows.
|
|
* 0x2190 - 0x21FF.
|
|
*/
|
|
public static final UnicodeBlock ARROWS
|
|
= new UnicodeBlock(0x2190, 0x21FF,
|
|
"ARROWS",
|
|
"Arrows");
|
|
|
|
/**
|
|
* Mathematical Operators.
|
|
* 0x2200 - 0x22FF.
|
|
*/
|
|
public static final UnicodeBlock MATHEMATICAL_OPERATORS
|
|
= new UnicodeBlock(0x2200, 0x22FF,
|
|
"MATHEMATICAL_OPERATORS",
|
|
"Mathematical Operators");
|
|
|
|
/**
|
|
* Miscellaneous Technical.
|
|
* 0x2300 - 0x23FF.
|
|
*/
|
|
public static final UnicodeBlock MISCELLANEOUS_TECHNICAL
|
|
= new UnicodeBlock(0x2300, 0x23FF,
|
|
"MISCELLANEOUS_TECHNICAL",
|
|
"Miscellaneous Technical");
|
|
|
|
/**
|
|
* Control Pictures.
|
|
* 0x2400 - 0x243F.
|
|
*/
|
|
public static final UnicodeBlock CONTROL_PICTURES
|
|
= new UnicodeBlock(0x2400, 0x243F,
|
|
"CONTROL_PICTURES",
|
|
"Control Pictures");
|
|
|
|
/**
|
|
* Optical Character Recognition.
|
|
* 0x2440 - 0x245F.
|
|
*/
|
|
public static final UnicodeBlock OPTICAL_CHARACTER_RECOGNITION
|
|
= new UnicodeBlock(0x2440, 0x245F,
|
|
"OPTICAL_CHARACTER_RECOGNITION",
|
|
"Optical Character Recognition");
|
|
|
|
/**
|
|
* Enclosed Alphanumerics.
|
|
* 0x2460 - 0x24FF.
|
|
*/
|
|
public static final UnicodeBlock ENCLOSED_ALPHANUMERICS
|
|
= new UnicodeBlock(0x2460, 0x24FF,
|
|
"ENCLOSED_ALPHANUMERICS",
|
|
"Enclosed Alphanumerics");
|
|
|
|
/**
|
|
* Box Drawing.
|
|
* 0x2500 - 0x257F.
|
|
*/
|
|
public static final UnicodeBlock BOX_DRAWING
|
|
= new UnicodeBlock(0x2500, 0x257F,
|
|
"BOX_DRAWING",
|
|
"Box Drawing");
|
|
|
|
/**
|
|
* Block Elements.
|
|
* 0x2580 - 0x259F.
|
|
*/
|
|
public static final UnicodeBlock BLOCK_ELEMENTS
|
|
= new UnicodeBlock(0x2580, 0x259F,
|
|
"BLOCK_ELEMENTS",
|
|
"Block Elements");
|
|
|
|
/**
|
|
* Geometric Shapes.
|
|
* 0x25A0 - 0x25FF.
|
|
*/
|
|
public static final UnicodeBlock GEOMETRIC_SHAPES
|
|
= new UnicodeBlock(0x25A0, 0x25FF,
|
|
"GEOMETRIC_SHAPES",
|
|
"Geometric Shapes");
|
|
|
|
/**
|
|
* Miscellaneous Symbols.
|
|
* 0x2600 - 0x26FF.
|
|
*/
|
|
public static final UnicodeBlock MISCELLANEOUS_SYMBOLS
|
|
= new UnicodeBlock(0x2600, 0x26FF,
|
|
"MISCELLANEOUS_SYMBOLS",
|
|
"Miscellaneous Symbols");
|
|
|
|
/**
|
|
* Dingbats.
|
|
* 0x2700 - 0x27BF.
|
|
*/
|
|
public static final UnicodeBlock DINGBATS
|
|
= new UnicodeBlock(0x2700, 0x27BF,
|
|
"DINGBATS",
|
|
"Dingbats");
|
|
|
|
/**
|
|
* Miscellaneous Mathematical Symbols-A.
|
|
* 0x27C0 - 0x27EF.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock MISCELLANEOUS_MATHEMATICAL_SYMBOLS_A
|
|
= new UnicodeBlock(0x27C0, 0x27EF,
|
|
"MISCELLANEOUS_MATHEMATICAL_SYMBOLS_A",
|
|
"Miscellaneous Mathematical Symbols-A");
|
|
|
|
/**
|
|
* Supplemental Arrows-A.
|
|
* 0x27F0 - 0x27FF.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock SUPPLEMENTAL_ARROWS_A
|
|
= new UnicodeBlock(0x27F0, 0x27FF,
|
|
"SUPPLEMENTAL_ARROWS_A",
|
|
"Supplemental Arrows-A");
|
|
|
|
/**
|
|
* Braille Patterns.
|
|
* 0x2800 - 0x28FF.
|
|
* @since 1.4
|
|
*/
|
|
public static final UnicodeBlock BRAILLE_PATTERNS
|
|
= new UnicodeBlock(0x2800, 0x28FF,
|
|
"BRAILLE_PATTERNS",
|
|
"Braille Patterns");
|
|
|
|
/**
|
|
* Supplemental Arrows-B.
|
|
* 0x2900 - 0x297F.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock SUPPLEMENTAL_ARROWS_B
|
|
= new UnicodeBlock(0x2900, 0x297F,
|
|
"SUPPLEMENTAL_ARROWS_B",
|
|
"Supplemental Arrows-B");
|
|
|
|
/**
|
|
* Miscellaneous Mathematical Symbols-B.
|
|
* 0x2980 - 0x29FF.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock MISCELLANEOUS_MATHEMATICAL_SYMBOLS_B
|
|
= new UnicodeBlock(0x2980, 0x29FF,
|
|
"MISCELLANEOUS_MATHEMATICAL_SYMBOLS_B",
|
|
"Miscellaneous Mathematical Symbols-B");
|
|
|
|
/**
|
|
* Supplemental Mathematical Operators.
|
|
* 0x2A00 - 0x2AFF.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock SUPPLEMENTAL_MATHEMATICAL_OPERATORS
|
|
= new UnicodeBlock(0x2A00, 0x2AFF,
|
|
"SUPPLEMENTAL_MATHEMATICAL_OPERATORS",
|
|
"Supplemental Mathematical Operators");
|
|
|
|
/**
|
|
* Miscellaneous Symbols and Arrows.
|
|
* 0x2B00 - 0x2BFF.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock MISCELLANEOUS_SYMBOLS_AND_ARROWS
|
|
= new UnicodeBlock(0x2B00, 0x2BFF,
|
|
"MISCELLANEOUS_SYMBOLS_AND_ARROWS",
|
|
"Miscellaneous Symbols and Arrows");
|
|
|
|
/**
|
|
* CJK Radicals Supplement.
|
|
* 0x2E80 - 0x2EFF.
|
|
* @since 1.4
|
|
*/
|
|
public static final UnicodeBlock CJK_RADICALS_SUPPLEMENT
|
|
= new UnicodeBlock(0x2E80, 0x2EFF,
|
|
"CJK_RADICALS_SUPPLEMENT",
|
|
"CJK Radicals Supplement");
|
|
|
|
/**
|
|
* Kangxi Radicals.
|
|
* 0x2F00 - 0x2FDF.
|
|
* @since 1.4
|
|
*/
|
|
public static final UnicodeBlock KANGXI_RADICALS
|
|
= new UnicodeBlock(0x2F00, 0x2FDF,
|
|
"KANGXI_RADICALS",
|
|
"Kangxi Radicals");
|
|
|
|
/**
|
|
* Ideographic Description Characters.
|
|
* 0x2FF0 - 0x2FFF.
|
|
* @since 1.4
|
|
*/
|
|
public static final UnicodeBlock IDEOGRAPHIC_DESCRIPTION_CHARACTERS
|
|
= new UnicodeBlock(0x2FF0, 0x2FFF,
|
|
"IDEOGRAPHIC_DESCRIPTION_CHARACTERS",
|
|
"Ideographic Description Characters");
|
|
|
|
/**
|
|
* CJK Symbols and Punctuation.
|
|
* 0x3000 - 0x303F.
|
|
*/
|
|
public static final UnicodeBlock CJK_SYMBOLS_AND_PUNCTUATION
|
|
= new UnicodeBlock(0x3000, 0x303F,
|
|
"CJK_SYMBOLS_AND_PUNCTUATION",
|
|
"CJK Symbols and Punctuation");
|
|
|
|
/**
|
|
* Hiragana.
|
|
* 0x3040 - 0x309F.
|
|
*/
|
|
public static final UnicodeBlock HIRAGANA
|
|
= new UnicodeBlock(0x3040, 0x309F,
|
|
"HIRAGANA",
|
|
"Hiragana");
|
|
|
|
/**
|
|
* Katakana.
|
|
* 0x30A0 - 0x30FF.
|
|
*/
|
|
public static final UnicodeBlock KATAKANA
|
|
= new UnicodeBlock(0x30A0, 0x30FF,
|
|
"KATAKANA",
|
|
"Katakana");
|
|
|
|
/**
|
|
* Bopomofo.
|
|
* 0x3100 - 0x312F.
|
|
*/
|
|
public static final UnicodeBlock BOPOMOFO
|
|
= new UnicodeBlock(0x3100, 0x312F,
|
|
"BOPOMOFO",
|
|
"Bopomofo");
|
|
|
|
/**
|
|
* Hangul Compatibility Jamo.
|
|
* 0x3130 - 0x318F.
|
|
*/
|
|
public static final UnicodeBlock HANGUL_COMPATIBILITY_JAMO
|
|
= new UnicodeBlock(0x3130, 0x318F,
|
|
"HANGUL_COMPATIBILITY_JAMO",
|
|
"Hangul Compatibility Jamo");
|
|
|
|
/**
|
|
* Kanbun.
|
|
* 0x3190 - 0x319F.
|
|
*/
|
|
public static final UnicodeBlock KANBUN
|
|
= new UnicodeBlock(0x3190, 0x319F,
|
|
"KANBUN",
|
|
"Kanbun");
|
|
|
|
/**
|
|
* Bopomofo Extended.
|
|
* 0x31A0 - 0x31BF.
|
|
* @since 1.4
|
|
*/
|
|
public static final UnicodeBlock BOPOMOFO_EXTENDED
|
|
= new UnicodeBlock(0x31A0, 0x31BF,
|
|
"BOPOMOFO_EXTENDED",
|
|
"Bopomofo Extended");
|
|
|
|
/**
|
|
* Katakana Phonetic Extensions.
|
|
* 0x31F0 - 0x31FF.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock KATAKANA_PHONETIC_EXTENSIONS
|
|
= new UnicodeBlock(0x31F0, 0x31FF,
|
|
"KATAKANA_PHONETIC_EXTENSIONS",
|
|
"Katakana Phonetic Extensions");
|
|
|
|
/**
|
|
* Enclosed CJK Letters and Months.
|
|
* 0x3200 - 0x32FF.
|
|
*/
|
|
public static final UnicodeBlock ENCLOSED_CJK_LETTERS_AND_MONTHS
|
|
= new UnicodeBlock(0x3200, 0x32FF,
|
|
"ENCLOSED_CJK_LETTERS_AND_MONTHS",
|
|
"Enclosed CJK Letters and Months");
|
|
|
|
/**
|
|
* CJK Compatibility.
|
|
* 0x3300 - 0x33FF.
|
|
*/
|
|
public static final UnicodeBlock CJK_COMPATIBILITY
|
|
= new UnicodeBlock(0x3300, 0x33FF,
|
|
"CJK_COMPATIBILITY",
|
|
"CJK Compatibility");
|
|
|
|
/**
|
|
* CJK Unified Ideographs Extension A.
|
|
* 0x3400 - 0x4DBF.
|
|
* @since 1.4
|
|
*/
|
|
public static final UnicodeBlock CJK_UNIFIED_IDEOGRAPHS_EXTENSION_A
|
|
= new UnicodeBlock(0x3400, 0x4DBF,
|
|
"CJK_UNIFIED_IDEOGRAPHS_EXTENSION_A",
|
|
"CJK Unified Ideographs Extension A");
|
|
|
|
/**
|
|
* Yijing Hexagram Symbols.
|
|
* 0x4DC0 - 0x4DFF.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock YIJING_HEXAGRAM_SYMBOLS
|
|
= new UnicodeBlock(0x4DC0, 0x4DFF,
|
|
"YIJING_HEXAGRAM_SYMBOLS",
|
|
"Yijing Hexagram Symbols");
|
|
|
|
/**
|
|
* CJK Unified Ideographs.
|
|
* 0x4E00 - 0x9FFF.
|
|
*/
|
|
public static final UnicodeBlock CJK_UNIFIED_IDEOGRAPHS
|
|
= new UnicodeBlock(0x4E00, 0x9FFF,
|
|
"CJK_UNIFIED_IDEOGRAPHS",
|
|
"CJK Unified Ideographs");
|
|
|
|
/**
|
|
* Yi Syllables.
|
|
* 0xA000 - 0xA48F.
|
|
* @since 1.4
|
|
*/
|
|
public static final UnicodeBlock YI_SYLLABLES
|
|
= new UnicodeBlock(0xA000, 0xA48F,
|
|
"YI_SYLLABLES",
|
|
"Yi Syllables");
|
|
|
|
/**
|
|
* Yi Radicals.
|
|
* 0xA490 - 0xA4CF.
|
|
* @since 1.4
|
|
*/
|
|
public static final UnicodeBlock YI_RADICALS
|
|
= new UnicodeBlock(0xA490, 0xA4CF,
|
|
"YI_RADICALS",
|
|
"Yi Radicals");
|
|
|
|
/**
|
|
* Hangul Syllables.
|
|
* 0xAC00 - 0xD7AF.
|
|
*/
|
|
public static final UnicodeBlock HANGUL_SYLLABLES
|
|
= new UnicodeBlock(0xAC00, 0xD7AF,
|
|
"HANGUL_SYLLABLES",
|
|
"Hangul Syllables");
|
|
|
|
/**
|
|
* High Surrogates.
|
|
* 0xD800 - 0xDB7F.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock HIGH_SURROGATES
|
|
= new UnicodeBlock(0xD800, 0xDB7F,
|
|
"HIGH_SURROGATES",
|
|
"High Surrogates");
|
|
|
|
/**
|
|
* High Private Use Surrogates.
|
|
* 0xDB80 - 0xDBFF.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock HIGH_PRIVATE_USE_SURROGATES
|
|
= new UnicodeBlock(0xDB80, 0xDBFF,
|
|
"HIGH_PRIVATE_USE_SURROGATES",
|
|
"High Private Use Surrogates");
|
|
|
|
/**
|
|
* Low Surrogates.
|
|
* 0xDC00 - 0xDFFF.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock LOW_SURROGATES
|
|
= new UnicodeBlock(0xDC00, 0xDFFF,
|
|
"LOW_SURROGATES",
|
|
"Low Surrogates");
|
|
|
|
/**
|
|
* Private Use Area.
|
|
* 0xE000 - 0xF8FF.
|
|
*/
|
|
public static final UnicodeBlock PRIVATE_USE_AREA
|
|
= new UnicodeBlock(0xE000, 0xF8FF,
|
|
"PRIVATE_USE_AREA",
|
|
"Private Use Area");
|
|
|
|
/**
|
|
* CJK Compatibility Ideographs.
|
|
* 0xF900 - 0xFAFF.
|
|
*/
|
|
public static final UnicodeBlock CJK_COMPATIBILITY_IDEOGRAPHS
|
|
= new UnicodeBlock(0xF900, 0xFAFF,
|
|
"CJK_COMPATIBILITY_IDEOGRAPHS",
|
|
"CJK Compatibility Ideographs");
|
|
|
|
/**
|
|
* Alphabetic Presentation Forms.
|
|
* 0xFB00 - 0xFB4F.
|
|
*/
|
|
public static final UnicodeBlock ALPHABETIC_PRESENTATION_FORMS
|
|
= new UnicodeBlock(0xFB00, 0xFB4F,
|
|
"ALPHABETIC_PRESENTATION_FORMS",
|
|
"Alphabetic Presentation Forms");
|
|
|
|
/**
|
|
* Arabic Presentation Forms-A.
|
|
* 0xFB50 - 0xFDFF.
|
|
*/
|
|
public static final UnicodeBlock ARABIC_PRESENTATION_FORMS_A
|
|
= new UnicodeBlock(0xFB50, 0xFDFF,
|
|
"ARABIC_PRESENTATION_FORMS_A",
|
|
"Arabic Presentation Forms-A");
|
|
|
|
/**
|
|
* Variation Selectors.
|
|
* 0xFE00 - 0xFE0F.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock VARIATION_SELECTORS
|
|
= new UnicodeBlock(0xFE00, 0xFE0F,
|
|
"VARIATION_SELECTORS",
|
|
"Variation Selectors");
|
|
|
|
/**
|
|
* Combining Half Marks.
|
|
* 0xFE20 - 0xFE2F.
|
|
*/
|
|
public static final UnicodeBlock COMBINING_HALF_MARKS
|
|
= new UnicodeBlock(0xFE20, 0xFE2F,
|
|
"COMBINING_HALF_MARKS",
|
|
"Combining Half Marks");
|
|
|
|
/**
|
|
* CJK Compatibility Forms.
|
|
* 0xFE30 - 0xFE4F.
|
|
*/
|
|
public static final UnicodeBlock CJK_COMPATIBILITY_FORMS
|
|
= new UnicodeBlock(0xFE30, 0xFE4F,
|
|
"CJK_COMPATIBILITY_FORMS",
|
|
"CJK Compatibility Forms");
|
|
|
|
/**
|
|
* Small Form Variants.
|
|
* 0xFE50 - 0xFE6F.
|
|
*/
|
|
public static final UnicodeBlock SMALL_FORM_VARIANTS
|
|
= new UnicodeBlock(0xFE50, 0xFE6F,
|
|
"SMALL_FORM_VARIANTS",
|
|
"Small Form Variants");
|
|
|
|
/**
|
|
* Arabic Presentation Forms-B.
|
|
* 0xFE70 - 0xFEFF.
|
|
*/
|
|
public static final UnicodeBlock ARABIC_PRESENTATION_FORMS_B
|
|
= new UnicodeBlock(0xFE70, 0xFEFF,
|
|
"ARABIC_PRESENTATION_FORMS_B",
|
|
"Arabic Presentation Forms-B");
|
|
|
|
/**
|
|
* Halfwidth and Fullwidth Forms.
|
|
* 0xFF00 - 0xFFEF.
|
|
*/
|
|
public static final UnicodeBlock HALFWIDTH_AND_FULLWIDTH_FORMS
|
|
= new UnicodeBlock(0xFF00, 0xFFEF,
|
|
"HALFWIDTH_AND_FULLWIDTH_FORMS",
|
|
"Halfwidth and Fullwidth Forms");
|
|
|
|
/**
|
|
* Specials.
|
|
* 0xFFF0 - 0xFFFF.
|
|
*/
|
|
public static final UnicodeBlock SPECIALS
|
|
= new UnicodeBlock(0xFFF0, 0xFFFF,
|
|
"SPECIALS",
|
|
"Specials");
|
|
|
|
/**
|
|
* Linear B Syllabary.
|
|
* 0x10000 - 0x1007F.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock LINEAR_B_SYLLABARY
|
|
= new UnicodeBlock(0x10000, 0x1007F,
|
|
"LINEAR_B_SYLLABARY",
|
|
"Linear B Syllabary");
|
|
|
|
/**
|
|
* Linear B Ideograms.
|
|
* 0x10080 - 0x100FF.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock LINEAR_B_IDEOGRAMS
|
|
= new UnicodeBlock(0x10080, 0x100FF,
|
|
"LINEAR_B_IDEOGRAMS",
|
|
"Linear B Ideograms");
|
|
|
|
/**
|
|
* Aegean Numbers.
|
|
* 0x10100 - 0x1013F.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock AEGEAN_NUMBERS
|
|
= new UnicodeBlock(0x10100, 0x1013F,
|
|
"AEGEAN_NUMBERS",
|
|
"Aegean Numbers");
|
|
|
|
/**
|
|
* Old Italic.
|
|
* 0x10300 - 0x1032F.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock OLD_ITALIC
|
|
= new UnicodeBlock(0x10300, 0x1032F,
|
|
"OLD_ITALIC",
|
|
"Old Italic");
|
|
|
|
/**
|
|
* Gothic.
|
|
* 0x10330 - 0x1034F.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock GOTHIC
|
|
= new UnicodeBlock(0x10330, 0x1034F,
|
|
"GOTHIC",
|
|
"Gothic");
|
|
|
|
/**
|
|
* Ugaritic.
|
|
* 0x10380 - 0x1039F.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock UGARITIC
|
|
= new UnicodeBlock(0x10380, 0x1039F,
|
|
"UGARITIC",
|
|
"Ugaritic");
|
|
|
|
/**
|
|
* Deseret.
|
|
* 0x10400 - 0x1044F.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock DESERET
|
|
= new UnicodeBlock(0x10400, 0x1044F,
|
|
"DESERET",
|
|
"Deseret");
|
|
|
|
/**
|
|
* Shavian.
|
|
* 0x10450 - 0x1047F.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock SHAVIAN
|
|
= new UnicodeBlock(0x10450, 0x1047F,
|
|
"SHAVIAN",
|
|
"Shavian");
|
|
|
|
/**
|
|
* Osmanya.
|
|
* 0x10480 - 0x104AF.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock OSMANYA
|
|
= new UnicodeBlock(0x10480, 0x104AF,
|
|
"OSMANYA",
|
|
"Osmanya");
|
|
|
|
/**
|
|
* Cypriot Syllabary.
|
|
* 0x10800 - 0x1083F.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock CYPRIOT_SYLLABARY
|
|
= new UnicodeBlock(0x10800, 0x1083F,
|
|
"CYPRIOT_SYLLABARY",
|
|
"Cypriot Syllabary");
|
|
|
|
/**
|
|
* Byzantine Musical Symbols.
|
|
* 0x1D000 - 0x1D0FF.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock BYZANTINE_MUSICAL_SYMBOLS
|
|
= new UnicodeBlock(0x1D000, 0x1D0FF,
|
|
"BYZANTINE_MUSICAL_SYMBOLS",
|
|
"Byzantine Musical Symbols");
|
|
|
|
/**
|
|
* Musical Symbols.
|
|
* 0x1D100 - 0x1D1FF.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock MUSICAL_SYMBOLS
|
|
= new UnicodeBlock(0x1D100, 0x1D1FF,
|
|
"MUSICAL_SYMBOLS",
|
|
"Musical Symbols");
|
|
|
|
/**
|
|
* Tai Xuan Jing Symbols.
|
|
* 0x1D300 - 0x1D35F.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock TAI_XUAN_JING_SYMBOLS
|
|
= new UnicodeBlock(0x1D300, 0x1D35F,
|
|
"TAI_XUAN_JING_SYMBOLS",
|
|
"Tai Xuan Jing Symbols");
|
|
|
|
/**
|
|
* Mathematical Alphanumeric Symbols.
|
|
* 0x1D400 - 0x1D7FF.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock MATHEMATICAL_ALPHANUMERIC_SYMBOLS
|
|
= new UnicodeBlock(0x1D400, 0x1D7FF,
|
|
"MATHEMATICAL_ALPHANUMERIC_SYMBOLS",
|
|
"Mathematical Alphanumeric Symbols");
|
|
|
|
/**
|
|
* CJK Unified Ideographs Extension B.
|
|
* 0x20000 - 0x2A6DF.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock CJK_UNIFIED_IDEOGRAPHS_EXTENSION_B
|
|
= new UnicodeBlock(0x20000, 0x2A6DF,
|
|
"CJK_UNIFIED_IDEOGRAPHS_EXTENSION_B",
|
|
"CJK Unified Ideographs Extension B");
|
|
|
|
/**
|
|
* CJK Compatibility Ideographs Supplement.
|
|
* 0x2F800 - 0x2FA1F.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock CJK_COMPATIBILITY_IDEOGRAPHS_SUPPLEMENT
|
|
= new UnicodeBlock(0x2F800, 0x2FA1F,
|
|
"CJK_COMPATIBILITY_IDEOGRAPHS_SUPPLEMENT",
|
|
"CJK Compatibility Ideographs Supplement");
|
|
|
|
/**
|
|
* Tags.
|
|
* 0xE0000 - 0xE007F.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock TAGS
|
|
= new UnicodeBlock(0xE0000, 0xE007F,
|
|
"TAGS",
|
|
"Tags");
|
|
|
|
/**
|
|
* Variation Selectors Supplement.
|
|
* 0xE0100 - 0xE01EF.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock VARIATION_SELECTORS_SUPPLEMENT
|
|
= new UnicodeBlock(0xE0100, 0xE01EF,
|
|
"VARIATION_SELECTORS_SUPPLEMENT",
|
|
"Variation Selectors Supplement");
|
|
|
|
/**
|
|
* Supplementary Private Use Area-A.
|
|
* 0xF0000 - 0xFFFFF.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock SUPPLEMENTARY_PRIVATE_USE_AREA_A
|
|
= new UnicodeBlock(0xF0000, 0xFFFFF,
|
|
"SUPPLEMENTARY_PRIVATE_USE_AREA_A",
|
|
"Supplementary Private Use Area-A");
|
|
|
|
/**
|
|
* Supplementary Private Use Area-B.
|
|
* 0x100000 - 0x10FFFF.
|
|
* @since 1.5
|
|
*/
|
|
public static final UnicodeBlock SUPPLEMENTARY_PRIVATE_USE_AREA_B
|
|
= new UnicodeBlock(0x100000, 0x10FFFF,
|
|
"SUPPLEMENTARY_PRIVATE_USE_AREA_B",
|
|
"Supplementary Private Use Area-B");
|
|
|
|
/**
|
|
* Surrogates Area.
|
|
* 'D800' - 'DFFF'.
|
|
* @deprecated As of 1.5, the three areas,
|
|
* <a href="#HIGH_SURROGATES">HIGH_SURROGATES</a>,
|
|
* <a href="#HIGH_PRIVATE_USE_SURROGATES">HIGH_PRIVATE_USE_SURROGATES</a>
|
|
* and <a href="#LOW_SURROGATES">LOW_SURROGATES</a>, as defined
|
|
* by the Unicode standard, should be used in preference to
|
|
* this. These are also returned from calls to <code>of(int)</code>
|
|
* and <code>of(char)</code>.
|
|
*/
|
|
@Deprecated
|
|
public static final UnicodeBlock SURROGATES_AREA
|
|
= new UnicodeBlock(0xD800, 0xDFFF,
|
|
"SURROGATES_AREA",
|
|
"Surrogates Area");
|
|
|
|
/**
|
|
* The defined subsets.
|
|
*/
|
|
private static final UnicodeBlock sets[] = {
|
|
BASIC_LATIN,
|
|
LATIN_1_SUPPLEMENT,
|
|
LATIN_EXTENDED_A,
|
|
LATIN_EXTENDED_B,
|
|
IPA_EXTENSIONS,
|
|
SPACING_MODIFIER_LETTERS,
|
|
COMBINING_DIACRITICAL_MARKS,
|
|
GREEK,
|
|
CYRILLIC,
|
|
CYRILLIC_SUPPLEMENTARY,
|
|
ARMENIAN,
|
|
HEBREW,
|
|
ARABIC,
|
|
SYRIAC,
|
|
THAANA,
|
|
DEVANAGARI,
|
|
BENGALI,
|
|
GURMUKHI,
|
|
GUJARATI,
|
|
ORIYA,
|
|
TAMIL,
|
|
TELUGU,
|
|
KANNADA,
|
|
MALAYALAM,
|
|
SINHALA,
|
|
THAI,
|
|
LAO,
|
|
TIBETAN,
|
|
MYANMAR,
|
|
GEORGIAN,
|
|
HANGUL_JAMO,
|
|
ETHIOPIC,
|
|
CHEROKEE,
|
|
UNIFIED_CANADIAN_ABORIGINAL_SYLLABICS,
|
|
OGHAM,
|
|
RUNIC,
|
|
TAGALOG,
|
|
HANUNOO,
|
|
BUHID,
|
|
TAGBANWA,
|
|
KHMER,
|
|
MONGOLIAN,
|
|
LIMBU,
|
|
TAI_LE,
|
|
KHMER_SYMBOLS,
|
|
PHONETIC_EXTENSIONS,
|
|
LATIN_EXTENDED_ADDITIONAL,
|
|
GREEK_EXTENDED,
|
|
GENERAL_PUNCTUATION,
|
|
SUPERSCRIPTS_AND_SUBSCRIPTS,
|
|
CURRENCY_SYMBOLS,
|
|
COMBINING_MARKS_FOR_SYMBOLS,
|
|
LETTERLIKE_SYMBOLS,
|
|
NUMBER_FORMS,
|
|
ARROWS,
|
|
MATHEMATICAL_OPERATORS,
|
|
MISCELLANEOUS_TECHNICAL,
|
|
CONTROL_PICTURES,
|
|
OPTICAL_CHARACTER_RECOGNITION,
|
|
ENCLOSED_ALPHANUMERICS,
|
|
BOX_DRAWING,
|
|
BLOCK_ELEMENTS,
|
|
GEOMETRIC_SHAPES,
|
|
MISCELLANEOUS_SYMBOLS,
|
|
DINGBATS,
|
|
MISCELLANEOUS_MATHEMATICAL_SYMBOLS_A,
|
|
SUPPLEMENTAL_ARROWS_A,
|
|
BRAILLE_PATTERNS,
|
|
SUPPLEMENTAL_ARROWS_B,
|
|
MISCELLANEOUS_MATHEMATICAL_SYMBOLS_B,
|
|
SUPPLEMENTAL_MATHEMATICAL_OPERATORS,
|
|
MISCELLANEOUS_SYMBOLS_AND_ARROWS,
|
|
CJK_RADICALS_SUPPLEMENT,
|
|
KANGXI_RADICALS,
|
|
IDEOGRAPHIC_DESCRIPTION_CHARACTERS,
|
|
CJK_SYMBOLS_AND_PUNCTUATION,
|
|
HIRAGANA,
|
|
KATAKANA,
|
|
BOPOMOFO,
|
|
HANGUL_COMPATIBILITY_JAMO,
|
|
KANBUN,
|
|
BOPOMOFO_EXTENDED,
|
|
KATAKANA_PHONETIC_EXTENSIONS,
|
|
ENCLOSED_CJK_LETTERS_AND_MONTHS,
|
|
CJK_COMPATIBILITY,
|
|
CJK_UNIFIED_IDEOGRAPHS_EXTENSION_A,
|
|
YIJING_HEXAGRAM_SYMBOLS,
|
|
CJK_UNIFIED_IDEOGRAPHS,
|
|
YI_SYLLABLES,
|
|
YI_RADICALS,
|
|
HANGUL_SYLLABLES,
|
|
HIGH_SURROGATES,
|
|
HIGH_PRIVATE_USE_SURROGATES,
|
|
LOW_SURROGATES,
|
|
PRIVATE_USE_AREA,
|
|
CJK_COMPATIBILITY_IDEOGRAPHS,
|
|
ALPHABETIC_PRESENTATION_FORMS,
|
|
ARABIC_PRESENTATION_FORMS_A,
|
|
VARIATION_SELECTORS,
|
|
COMBINING_HALF_MARKS,
|
|
CJK_COMPATIBILITY_FORMS,
|
|
SMALL_FORM_VARIANTS,
|
|
ARABIC_PRESENTATION_FORMS_B,
|
|
HALFWIDTH_AND_FULLWIDTH_FORMS,
|
|
SPECIALS,
|
|
LINEAR_B_SYLLABARY,
|
|
LINEAR_B_IDEOGRAMS,
|
|
AEGEAN_NUMBERS,
|
|
OLD_ITALIC,
|
|
GOTHIC,
|
|
UGARITIC,
|
|
DESERET,
|
|
SHAVIAN,
|
|
OSMANYA,
|
|
CYPRIOT_SYLLABARY,
|
|
BYZANTINE_MUSICAL_SYMBOLS,
|
|
MUSICAL_SYMBOLS,
|
|
TAI_XUAN_JING_SYMBOLS,
|
|
MATHEMATICAL_ALPHANUMERIC_SYMBOLS,
|
|
CJK_UNIFIED_IDEOGRAPHS_EXTENSION_B,
|
|
CJK_COMPATIBILITY_IDEOGRAPHS_SUPPLEMENT,
|
|
TAGS,
|
|
VARIATION_SELECTORS_SUPPLEMENT,
|
|
SUPPLEMENTARY_PRIVATE_USE_AREA_A,
|
|
SUPPLEMENTARY_PRIVATE_USE_AREA_B,
|
|
};
|
|
} // class UnicodeBlock
|
|
|
|
/**
|
|
* The immutable value of this Character.
|
|
*
|
|
* @serial the value of this Character
|
|
*/
|
|
private final char value;
|
|
|
|
/**
|
|
* Compatible with JDK 1.0+.
|
|
*/
|
|
private static final long serialVersionUID = 3786198910865385080L;
|
|
|
|
/**
|
|
* Smallest value allowed for radix arguments in Java. This value is 2.
|
|
*
|
|
* @see #digit(char, int)
|
|
* @see #forDigit(int, int)
|
|
* @see Integer#toString(int, int)
|
|
* @see Integer#valueOf(String)
|
|
*/
|
|
public static final int MIN_RADIX = 2;
|
|
|
|
/**
|
|
* Largest value allowed for radix arguments in Java. This value is 36.
|
|
*
|
|
* @see #digit(char, int)
|
|
* @see #forDigit(int, int)
|
|
* @see Integer#toString(int, int)
|
|
* @see Integer#valueOf(String)
|
|
*/
|
|
public static final int MAX_RADIX = 36;
|
|
|
|
/**
|
|
* The minimum value the char data type can hold.
|
|
* This value is <code>'\\u0000'</code>.
|
|
*/
|
|
public static final char MIN_VALUE = '\u0000';
|
|
|
|
/**
|
|
* The maximum value the char data type can hold.
|
|
* This value is <code>'\\uFFFF'</code>.
|
|
*/
|
|
public static final char MAX_VALUE = '\uFFFF';
|
|
|
|
/**
|
|
* The minimum Unicode 4.0 code point. This value is <code>0</code>.
|
|
* @since 1.5
|
|
*/
|
|
public static final int MIN_CODE_POINT = 0;
|
|
|
|
/**
|
|
* The maximum Unicode 4.0 code point, which is greater than the range
|
|
* of the char data type.
|
|
* This value is <code>0x10FFFF</code>.
|
|
* @since 1.5
|
|
*/
|
|
public static final int MAX_CODE_POINT = 0x10FFFF;
|
|
|
|
/**
|
|
* The minimum Unicode high surrogate code unit, or
|
|
* <emph>leading-surrogate</emph>, in the UTF-16 character encoding.
|
|
* This value is <code>'\uD800'</code>.
|
|
* @since 1.5
|
|
*/
|
|
public static final char MIN_HIGH_SURROGATE = '\uD800';
|
|
|
|
/**
|
|
* The maximum Unicode high surrogate code unit, or
|
|
* <emph>leading-surrogate</emph>, in the UTF-16 character encoding.
|
|
* This value is <code>'\uDBFF'</code>.
|
|
* @since 1.5
|
|
*/
|
|
public static final char MAX_HIGH_SURROGATE = '\uDBFF';
|
|
|
|
/**
|
|
* The minimum Unicode low surrogate code unit, or
|
|
* <emph>trailing-surrogate</emph>, in the UTF-16 character encoding.
|
|
* This value is <code>'\uDC00'</code>.
|
|
* @since 1.5
|
|
*/
|
|
public static final char MIN_LOW_SURROGATE = '\uDC00';
|
|
|
|
/**
|
|
* The maximum Unicode low surrogate code unit, or
|
|
* <emph>trailing-surrogate</emph>, in the UTF-16 character encoding.
|
|
* This value is <code>'\uDFFF'</code>.
|
|
* @since 1.5
|
|
*/
|
|
public static final char MAX_LOW_SURROGATE = '\uDFFF';
|
|
|
|
/**
|
|
* The minimum Unicode surrogate code unit in the UTF-16 character encoding.
|
|
* This value is <code>'\uD800'</code>.
|
|
* @since 1.5
|
|
*/
|
|
public static final char MIN_SURROGATE = MIN_HIGH_SURROGATE;
|
|
|
|
/**
|
|
* The maximum Unicode surrogate code unit in the UTF-16 character encoding.
|
|
* This value is <code>'\uDFFF'</code>.
|
|
* @since 1.5
|
|
*/
|
|
public static final char MAX_SURROGATE = MAX_LOW_SURROGATE;
|
|
|
|
/**
|
|
* The lowest possible supplementary Unicode code point (the first code
|
|
* point outside the basic multilingual plane (BMP)).
|
|
* This value is <code>0x10000</code>.
|
|
*/
|
|
public static final int MIN_SUPPLEMENTARY_CODE_POINT = 0x10000;
|
|
|
|
/**
|
|
* Class object representing the primitive char data type.
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final Class<Character> TYPE = (Class<Character>) VMClassLoader.getPrimitiveClass('C');
|
|
|
|
/**
|
|
* The number of bits needed to represent a <code>char</code>.
|
|
* @since 1.5
|
|
*/
|
|
public static final int SIZE = 16;
|
|
|
|
// This caches some Character values, and is used by boxing
|
|
// conversions via valueOf(). We must cache at least 0..127;
|
|
// this constant controls how much we actually cache.
|
|
private static final int MAX_CACHE = 127;
|
|
private static Character[] charCache = new Character[MAX_CACHE + 1];
|
|
|
|
/**
|
|
* Lu = Letter, Uppercase (Informative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte UPPERCASE_LETTER = 1;
|
|
|
|
/**
|
|
* Ll = Letter, Lowercase (Informative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte LOWERCASE_LETTER = 2;
|
|
|
|
/**
|
|
* Lt = Letter, Titlecase (Informative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte TITLECASE_LETTER = 3;
|
|
|
|
/**
|
|
* Mn = Mark, Non-Spacing (Normative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte NON_SPACING_MARK = 6;
|
|
|
|
/**
|
|
* Mc = Mark, Spacing Combining (Normative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte COMBINING_SPACING_MARK = 8;
|
|
|
|
/**
|
|
* Me = Mark, Enclosing (Normative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte ENCLOSING_MARK = 7;
|
|
|
|
/**
|
|
* Nd = Number, Decimal Digit (Normative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte DECIMAL_DIGIT_NUMBER = 9;
|
|
|
|
/**
|
|
* Nl = Number, Letter (Normative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte LETTER_NUMBER = 10;
|
|
|
|
/**
|
|
* No = Number, Other (Normative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte OTHER_NUMBER = 11;
|
|
|
|
/**
|
|
* Zs = Separator, Space (Normative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte SPACE_SEPARATOR = 12;
|
|
|
|
/**
|
|
* Zl = Separator, Line (Normative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte LINE_SEPARATOR = 13;
|
|
|
|
/**
|
|
* Zp = Separator, Paragraph (Normative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte PARAGRAPH_SEPARATOR = 14;
|
|
|
|
/**
|
|
* Cc = Other, Control (Normative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte CONTROL = 15;
|
|
|
|
/**
|
|
* Cf = Other, Format (Normative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte FORMAT = 16;
|
|
|
|
/**
|
|
* Cs = Other, Surrogate (Normative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte SURROGATE = 19;
|
|
|
|
/**
|
|
* Co = Other, Private Use (Normative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte PRIVATE_USE = 18;
|
|
|
|
/**
|
|
* Cn = Other, Not Assigned (Normative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte UNASSIGNED = 0;
|
|
|
|
/**
|
|
* Lm = Letter, Modifier (Informative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte MODIFIER_LETTER = 4;
|
|
|
|
/**
|
|
* Lo = Letter, Other (Informative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte OTHER_LETTER = 5;
|
|
|
|
/**
|
|
* Pc = Punctuation, Connector (Informative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte CONNECTOR_PUNCTUATION = 23;
|
|
|
|
/**
|
|
* Pd = Punctuation, Dash (Informative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte DASH_PUNCTUATION = 20;
|
|
|
|
/**
|
|
* Ps = Punctuation, Open (Informative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte START_PUNCTUATION = 21;
|
|
|
|
/**
|
|
* Pe = Punctuation, Close (Informative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte END_PUNCTUATION = 22;
|
|
|
|
/**
|
|
* Pi = Punctuation, Initial Quote (Informative).
|
|
*
|
|
* @since 1.4
|
|
*/
|
|
public static final byte INITIAL_QUOTE_PUNCTUATION = 29;
|
|
|
|
/**
|
|
* Pf = Punctuation, Final Quote (Informative).
|
|
*
|
|
* @since 1.4
|
|
*/
|
|
public static final byte FINAL_QUOTE_PUNCTUATION = 30;
|
|
|
|
/**
|
|
* Po = Punctuation, Other (Informative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte OTHER_PUNCTUATION = 24;
|
|
|
|
/**
|
|
* Sm = Symbol, Math (Informative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte MATH_SYMBOL = 25;
|
|
|
|
/**
|
|
* Sc = Symbol, Currency (Informative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte CURRENCY_SYMBOL = 26;
|
|
|
|
/**
|
|
* Sk = Symbol, Modifier (Informative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte MODIFIER_SYMBOL = 27;
|
|
|
|
/**
|
|
* So = Symbol, Other (Informative).
|
|
*
|
|
* @since 1.1
|
|
*/
|
|
public static final byte OTHER_SYMBOL = 28;
|
|
|
|
/**
|
|
* Undefined bidirectional character type. Undefined char values have
|
|
* undefined directionality in the Unicode specification.
|
|
*
|
|
* @since 1.4
|
|
*/
|
|
public static final byte DIRECTIONALITY_UNDEFINED = -1;
|
|
|
|
/**
|
|
* Strong bidirectional character type "L".
|
|
*
|
|
* @since 1.4
|
|
*/
|
|
public static final byte DIRECTIONALITY_LEFT_TO_RIGHT = 0;
|
|
|
|
/**
|
|
* Strong bidirectional character type "R".
|
|
*
|
|
* @since 1.4
|
|
*/
|
|
public static final byte DIRECTIONALITY_RIGHT_TO_LEFT = 1;
|
|
|
|
/**
|
|
* Strong bidirectional character type "AL".
|
|
*
|
|
* @since 1.4
|
|
*/
|
|
public static final byte DIRECTIONALITY_RIGHT_TO_LEFT_ARABIC = 2;
|
|
|
|
/**
|
|
* Weak bidirectional character type "EN".
|
|
*
|
|
* @since 1.4
|
|
*/
|
|
public static final byte DIRECTIONALITY_EUROPEAN_NUMBER = 3;
|
|
|
|
/**
|
|
* Weak bidirectional character type "ES".
|
|
*
|
|
* @since 1.4
|
|
*/
|
|
public static final byte DIRECTIONALITY_EUROPEAN_NUMBER_SEPARATOR = 4;
|
|
|
|
/**
|
|
* Weak bidirectional character type "ET".
|
|
*
|
|
* @since 1.4
|
|
*/
|
|
public static final byte DIRECTIONALITY_EUROPEAN_NUMBER_TERMINATOR = 5;
|
|
|
|
/**
|
|
* Weak bidirectional character type "AN".
|
|
*
|
|
* @since 1.4
|
|
*/
|
|
public static final byte DIRECTIONALITY_ARABIC_NUMBER = 6;
|
|
|
|
/**
|
|
* Weak bidirectional character type "CS".
|
|
*
|
|
* @since 1.4
|
|
*/
|
|
public static final byte DIRECTIONALITY_COMMON_NUMBER_SEPARATOR = 7;
|
|
|
|
/**
|
|
* Weak bidirectional character type "NSM".
|
|
*
|
|
* @since 1.4
|
|
*/
|
|
public static final byte DIRECTIONALITY_NONSPACING_MARK = 8;
|
|
|
|
/**
|
|
* Weak bidirectional character type "BN".
|
|
*
|
|
* @since 1.4
|
|
*/
|
|
public static final byte DIRECTIONALITY_BOUNDARY_NEUTRAL = 9;
|
|
|
|
/**
|
|
* Neutral bidirectional character type "B".
|
|
*
|
|
* @since 1.4
|
|
*/
|
|
public static final byte DIRECTIONALITY_PARAGRAPH_SEPARATOR = 10;
|
|
|
|
/**
|
|
* Neutral bidirectional character type "S".
|
|
*
|
|
* @since 1.4
|
|
*/
|
|
public static final byte DIRECTIONALITY_SEGMENT_SEPARATOR = 11;
|
|
|
|
/**
|
|
* Strong bidirectional character type "WS".
|
|
*
|
|
* @since 1.4
|
|
*/
|
|
public static final byte DIRECTIONALITY_WHITESPACE = 12;
|
|
|
|
/**
|
|
* Neutral bidirectional character type "ON".
|
|
*
|
|
* @since 1.4
|
|
*/
|
|
public static final byte DIRECTIONALITY_OTHER_NEUTRALS = 13;
|
|
|
|
/**
|
|
* Strong bidirectional character type "LRE".
|
|
*
|
|
* @since 1.4
|
|
*/
|
|
public static final byte DIRECTIONALITY_LEFT_TO_RIGHT_EMBEDDING = 14;
|
|
|
|
/**
|
|
* Strong bidirectional character type "LRO".
|
|
*
|
|
* @since 1.4
|
|
*/
|
|
public static final byte DIRECTIONALITY_LEFT_TO_RIGHT_OVERRIDE = 15;
|
|
|
|
/**
|
|
* Strong bidirectional character type "RLE".
|
|
*
|
|
* @since 1.4
|
|
*/
|
|
public static final byte DIRECTIONALITY_RIGHT_TO_LEFT_EMBEDDING = 16;
|
|
|
|
/**
|
|
* Strong bidirectional character type "RLO".
|
|
*
|
|
* @since 1.4
|
|
*/
|
|
public static final byte DIRECTIONALITY_RIGHT_TO_LEFT_OVERRIDE = 17;
|
|
|
|
/**
|
|
* Weak bidirectional character type "PDF".
|
|
*
|
|
* @since 1.4
|
|
*/
|
|
public static final byte DIRECTIONALITY_POP_DIRECTIONAL_FORMAT = 18;
|
|
|
|
/**
|
|
* Mask for grabbing the type out of the result of readChar.
|
|
* @see #readChar(char)
|
|
*/
|
|
private static final int TYPE_MASK = 0x1F;
|
|
|
|
/**
|
|
* Mask for grabbing the non-breaking space flag out of the result of
|
|
* readChar.
|
|
* @see #readChar(char)
|
|
*/
|
|
private static final int NO_BREAK_MASK = 0x20;
|
|
|
|
/**
|
|
* Mask for grabbing the mirrored directionality flag out of the result
|
|
* of readChar.
|
|
* @see #readChar(char)
|
|
*/
|
|
private static final int MIRROR_MASK = 0x40;
|
|
|
|
/**
|
|
* Grabs an attribute offset from the Unicode attribute database. The lower
|
|
* 5 bits are the character type, the next 2 bits are flags, and the top
|
|
* 9 bits are the offset into the attribute tables. Note that the top 9
|
|
* bits are meaningless in this context; they are useful only in the native
|
|
* code.
|
|
*
|
|
* @param ch the character to look up
|
|
* @return the character's attribute offset and type
|
|
* @see #TYPE_MASK
|
|
* @see #NO_BREAK_MASK
|
|
* @see #MIRROR_MASK
|
|
*/
|
|
private static native char readChar(char ch);
|
|
|
|
/**
|
|
* Grabs an attribute offset from the Unicode attribute database. The lower
|
|
* 5 bits are the character type, the next 2 bits are flags, and the top
|
|
* 9 bits are the offset into the attribute tables. Note that the top 9
|
|
* bits are meaningless in this context; they are useful only in the native
|
|
* code.
|
|
*
|
|
* @param codePoint the character to look up
|
|
* @return the character's attribute offset and type
|
|
* @see #TYPE_MASK
|
|
* @see #NO_BREAK_MASK
|
|
* @see #MIRROR_MASK
|
|
*/
|
|
private static native char readCodePoint(int codePoint);
|
|
|
|
/**
|
|
* Wraps up a character.
|
|
*
|
|
* @param value the character to wrap
|
|
*/
|
|
public Character(char value)
|
|
{
|
|
this.value = value;
|
|
}
|
|
|
|
/**
|
|
* Returns the character which has been wrapped by this class.
|
|
*
|
|
* @return the character wrapped
|
|
*/
|
|
public char charValue()
|
|
{
|
|
return value;
|
|
}
|
|
|
|
/**
|
|
* Returns the numerical value (unsigned) of the wrapped character.
|
|
* Range of returned values: 0x0000-0xFFFF.
|
|
*
|
|
* @return the value of the wrapped character
|
|
*/
|
|
public int hashCode()
|
|
{
|
|
return value;
|
|
}
|
|
|
|
/**
|
|
* Determines if an object is equal to this object. This is only true for
|
|
* another Character object wrapping the same value.
|
|
*
|
|
* @param o object to compare
|
|
* @return true if o is a Character with the same value
|
|
*/
|
|
public boolean equals(Object o)
|
|
{
|
|
return o instanceof Character && value == ((Character) o).value;
|
|
}
|
|
|
|
/**
|
|
* Converts the wrapped character into a String.
|
|
*
|
|
* @return a String containing one character -- the wrapped character
|
|
* of this instance
|
|
*/
|
|
public String toString()
|
|
{
|
|
// This assumes that String.valueOf(char) can create a single-character
|
|
// String more efficiently than through the public API.
|
|
return String.valueOf(value);
|
|
}
|
|
|
|
/**
|
|
* Returns a String of length 1 representing the specified character.
|
|
*
|
|
* @param ch the character to convert
|
|
* @return a String containing the character
|
|
* @since 1.4
|
|
*/
|
|
public static String toString(char ch)
|
|
{
|
|
// This assumes that String.valueOf(char) can create a single-character
|
|
// String more efficiently than through the public API.
|
|
return String.valueOf(ch);
|
|
}
|
|
|
|
/**
|
|
* Determines if a character is a Unicode lowercase letter. For example,
|
|
* <code>'a'</code> is lowercase.
|
|
* <br>
|
|
* lowercase = [Ll]
|
|
*
|
|
* @param ch character to test
|
|
* @return true if ch is a Unicode lowercase letter, else false
|
|
* @see #isUpperCase(char)
|
|
* @see #isTitleCase(char)
|
|
* @see #toLowerCase(char)
|
|
* @see #getType(char)
|
|
*/
|
|
public static boolean isLowerCase(char ch)
|
|
{
|
|
return getType(ch) == LOWERCASE_LETTER;
|
|
}
|
|
|
|
/**
|
|
* Determines if a character is a Unicode lowercase letter. For example,
|
|
* <code>'a'</code> is lowercase. Unlike isLowerCase(char), this method
|
|
* supports supplementary Unicode code points.
|
|
* <br>
|
|
* lowercase = [Ll]
|
|
*
|
|
* @param codePoint character to test
|
|
* @return true if codePoint is a Unicode lowercase letter, else false
|
|
* @see #isUpperCase(int)
|
|
* @see #isTitleCase(int)
|
|
* @see #toLowerCase(int)
|
|
* @see #getType(int)
|
|
* @since 1.5
|
|
*/
|
|
public static boolean isLowerCase(int codePoint)
|
|
{
|
|
return getType(codePoint) == LOWERCASE_LETTER;
|
|
}
|
|
|
|
/**
|
|
* Determines if a character is a Unicode uppercase letter. For example,
|
|
* <code>'A'</code> is uppercase.
|
|
* <br>
|
|
* uppercase = [Lu]
|
|
*
|
|
* @param ch character to test
|
|
* @return true if ch is a Unicode uppercase letter, else false
|
|
* @see #isLowerCase(char)
|
|
* @see #isTitleCase(char)
|
|
* @see #toUpperCase(char)
|
|
* @see #getType(char)
|
|
*/
|
|
public static boolean isUpperCase(char ch)
|
|
{
|
|
return getType(ch) == UPPERCASE_LETTER;
|
|
}
|
|
|
|
/**
|
|
* Determines if a character is a Unicode uppercase letter. For example,
|
|
* <code>'A'</code> is uppercase. Unlike isUpperCase(char), this method
|
|
* supports supplementary Unicode code points.
|
|
* <br>
|
|
* uppercase = [Lu]
|
|
*
|
|
* @param codePoint character to test
|
|
* @return true if codePoint is a Unicode uppercase letter, else false
|
|
* @see #isLowerCase(int)
|
|
* @see #isTitleCase(int)
|
|
* @see #toUpperCase(int)
|
|
* @see #getType(int)
|
|
* @since 1.5
|
|
*/
|
|
public static boolean isUpperCase(int codePoint)
|
|
{
|
|
return getType(codePoint) == UPPERCASE_LETTER;
|
|
}
|
|
|
|
/**
|
|
* Determines if a character is a Unicode titlecase letter. For example,
|
|
* the character "Lj" (Latin capital L with small letter j) is titlecase.
|
|
* <br>
|
|
* titlecase = [Lt]
|
|
*
|
|
* @param ch character to test
|
|
* @return true if ch is a Unicode titlecase letter, else false
|
|
* @see #isLowerCase(char)
|
|
* @see #isUpperCase(char)
|
|
* @see #toTitleCase(char)
|
|
* @see #getType(char)
|
|
*/
|
|
public static boolean isTitleCase(char ch)
|
|
{
|
|
return getType(ch) == TITLECASE_LETTER;
|
|
}
|
|
|
|
/**
|
|
* Determines if a character is a Unicode titlecase letter. For example,
|
|
* the character "Lj" (Latin capital L with small letter j) is titlecase.
|
|
* Unlike isTitleCase(char), this method supports supplementary Unicode
|
|
* code points.
|
|
* <br>
|
|
* titlecase = [Lt]
|
|
*
|
|
* @param codePoint character to test
|
|
* @return true if codePoint is a Unicode titlecase letter, else false
|
|
* @see #isLowerCase(int)
|
|
* @see #isUpperCase(int)
|
|
* @see #toTitleCase(int)
|
|
* @see #getType(int)
|
|
* @since 1.5
|
|
*/
|
|
public static boolean isTitleCase(int codePoint)
|
|
{
|
|
return getType(codePoint) == TITLECASE_LETTER;
|
|
}
|
|
|
|
/**
|
|
* Determines if a character is a Unicode decimal digit. For example,
|
|
* <code>'0'</code> is a digit.
|
|
* <br>
|
|
* Unicode decimal digit = [Nd]
|
|
*
|
|
* @param ch character to test
|
|
* @return true if ch is a Unicode decimal digit, else false
|
|
* @see #digit(char, int)
|
|
* @see #forDigit(int, int)
|
|
* @see #getType(char)
|
|
*/
|
|
public static boolean isDigit(char ch)
|
|
{
|
|
return getType(ch) == DECIMAL_DIGIT_NUMBER;
|
|
}
|
|
|
|
/**
|
|
* Determines if a character is a Unicode decimal digit. For example,
|
|
* <code>'0'</code> is a digit. Unlike isDigit(char), this method
|
|
* supports supplementary Unicode code points.
|
|
* <br>
|
|
* Unicode decimal digit = [Nd]
|
|
*
|
|
* @param codePoint character to test
|
|
* @return true if ccodePoint is a Unicode decimal digit, else false
|
|
* @see #digit(int, int)
|
|
* @see #forDigit(int, int)
|
|
* @see #getType(int)
|
|
* @since 1.5
|
|
*/
|
|
public static boolean isDigit(int codePoint)
|
|
{
|
|
return getType(codePoint) == DECIMAL_DIGIT_NUMBER;
|
|
}
|
|
|
|
/**
|
|
* Determines if a character is part of the Unicode Standard. This is an
|
|
* evolving standard, but covers every character in the data file.
|
|
* <br>
|
|
* defined = not [Cn]
|
|
*
|
|
* @param ch character to test
|
|
* @return true if ch is a Unicode character, else false
|
|
* @see #isDigit(char)
|
|
* @see #isLetter(char)
|
|
* @see #isLetterOrDigit(char)
|
|
* @see #isLowerCase(char)
|
|
* @see #isTitleCase(char)
|
|
* @see #isUpperCase(char)
|
|
*/
|
|
public static boolean isDefined(char ch)
|
|
{
|
|
return getType(ch) != UNASSIGNED;
|
|
}
|
|
|
|
/**
|
|
* Determines if a character is part of the Unicode Standard. This is an
|
|
* evolving standard, but covers every character in the data file. Unlike
|
|
* isDefined(char), this method supports supplementary Unicode code points.
|
|
* <br>
|
|
* defined = not [Cn]
|
|
*
|
|
* @param codePoint character to test
|
|
* @return true if codePoint is a Unicode character, else false
|
|
* @see #isDigit(int)
|
|
* @see #isLetter(int)
|
|
* @see #isLetterOrDigit(int)
|
|
* @see #isLowerCase(int)
|
|
* @see #isTitleCase(int)
|
|
* @see #isUpperCase(int)
|
|
* @since 1.5
|
|
*/
|
|
public static boolean isDefined(int codePoint)
|
|
{
|
|
return getType(codePoint) != UNASSIGNED;
|
|
}
|
|
|
|
/**
|
|
* Determines if a character is a Unicode letter. Not all letters have case,
|
|
* so this may return true when isLowerCase and isUpperCase return false.
|
|
* <br>
|
|
* letter = [Lu]|[Ll]|[Lt]|[Lm]|[Lo]
|
|
*
|
|
* @param ch character to test
|
|
* @return true if ch is a Unicode letter, else false
|
|
* @see #isDigit(char)
|
|
* @see #isJavaIdentifierStart(char)
|
|
* @see #isJavaLetter(char)
|
|
* @see #isJavaLetterOrDigit(char)
|
|
* @see #isLetterOrDigit(char)
|
|
* @see #isLowerCase(char)
|
|
* @see #isTitleCase(char)
|
|
* @see #isUnicodeIdentifierStart(char)
|
|
* @see #isUpperCase(char)
|
|
*/
|
|
public static boolean isLetter(char ch)
|
|
{
|
|
return ((1 << getType(ch))
|
|
& ((1 << UPPERCASE_LETTER)
|
|
| (1 << LOWERCASE_LETTER)
|
|
| (1 << TITLECASE_LETTER)
|
|
| (1 << MODIFIER_LETTER)
|
|
| (1 << OTHER_LETTER))) != 0;
|
|
}
|
|
|
|
/**
|
|
* Determines if a character is a Unicode letter. Not all letters have case,
|
|
* so this may return true when isLowerCase and isUpperCase return false.
|
|
* Unlike isLetter(char), this method supports supplementary Unicode code
|
|
* points.
|
|
* <br>
|
|
* letter = [Lu]|[Ll]|[Lt]|[Lm]|[Lo]
|
|
*
|
|
* @param codePoint character to test
|
|
* @return true if codePoint is a Unicode letter, else false
|
|
* @see #isDigit(int)
|
|
* @see #isJavaIdentifierStart(int)
|
|
* @see #isJavaLetter(int)
|
|
* @see #isJavaLetterOrDigit(int)
|
|
* @see #isLetterOrDigit(int)
|
|
* @see #isLowerCase(int)
|
|
* @see #isTitleCase(int)
|
|
* @see #isUnicodeIdentifierStart(int)
|
|
* @see #isUpperCase(int)
|
|
* @since 1.5
|
|
*/
|
|
public static boolean isLetter(int codePoint)
|
|
{
|
|
return ((1 << getType(codePoint))
|
|
& ((1 << UPPERCASE_LETTER)
|
|
| (1 << LOWERCASE_LETTER)
|
|
| (1 << TITLECASE_LETTER)
|
|
| (1 << MODIFIER_LETTER)
|
|
| (1 << OTHER_LETTER))) != 0;
|
|
}
|
|
|
|
/**
|
|
* Returns the index into the given CharSequence that is offset
|
|
* <code>codePointOffset</code> code points from <code>index</code>.
|
|
* @param seq the CharSequence
|
|
* @param index the start position in the CharSequence
|
|
* @param codePointOffset the number of code points offset from the start
|
|
* position
|
|
* @return the index into the CharSequence that is codePointOffset code
|
|
* points offset from index
|
|
*
|
|
* @throws NullPointerException if seq is null
|
|
* @throws IndexOutOfBoundsException if index is negative or greater than the
|
|
* length of the sequence.
|
|
* @throws IndexOutOfBoundsException if codePointOffset is positive and the
|
|
* subsequence from index to the end of seq has fewer than codePointOffset
|
|
* code points
|
|
* @throws IndexOutOfBoundsException if codePointOffset is negative and the
|
|
* subsequence from the start of seq to index has fewer than
|
|
* (-codePointOffset) code points
|
|
* @since 1.5
|
|
*/
|
|
public static int offsetByCodePoints(CharSequence seq,
|
|
int index,
|
|
int codePointOffset)
|
|
{
|
|
int len = seq.length();
|
|
if (index < 0 || index > len)
|
|
throw new IndexOutOfBoundsException();
|
|
|
|
int numToGo = codePointOffset;
|
|
int offset = index;
|
|
int adjust = 1;
|
|
if (numToGo >= 0)
|
|
{
|
|
for (; numToGo > 0; offset++)
|
|
{
|
|
numToGo--;
|
|
if (Character.isHighSurrogate(seq.charAt(offset))
|
|
&& (offset + 1) < len
|
|
&& Character.isLowSurrogate(seq.charAt(offset + 1)))
|
|
offset++;
|
|
}
|
|
return offset;
|
|
}
|
|
else
|
|
{
|
|
numToGo *= -1;
|
|
for (; numToGo > 0;)
|
|
{
|
|
numToGo--;
|
|
offset--;
|
|
if (Character.isLowSurrogate(seq.charAt(offset))
|
|
&& (offset - 1) >= 0
|
|
&& Character.isHighSurrogate(seq.charAt(offset - 1)))
|
|
offset--;
|
|
}
|
|
return offset;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns the index into the given char subarray that is offset
|
|
* <code>codePointOffset</code> code points from <code>index</code>.
|
|
* @param a the char array
|
|
* @param start the start index of the subarray
|
|
* @param count the length of the subarray
|
|
* @param index the index to be offset
|
|
* @param codePointOffset the number of code points offset from <code>index
|
|
* </code>
|
|
* @return the index into the char array
|
|
*
|
|
* @throws NullPointerException if a is null
|
|
* @throws IndexOutOfBoundsException if start or count is negative or if
|
|
* start + count is greater than the length of the array
|
|
* @throws IndexOutOfBoundsException if index is less than start or larger
|
|
* than start + count
|
|
* @throws IndexOutOfBoundsException if codePointOffset is positive and the
|
|
* subarray from index to start + count - 1 has fewer than codePointOffset
|
|
* code points.
|
|
* @throws IndexOutOfBoundsException if codePointOffset is negative and the
|
|
* subarray from start to index - 1 has fewer than (-codePointOffset) code
|
|
* points
|
|
* @since 1.5
|
|
|
|
*/
|
|
public static int offsetByCodePoints(char[] a,
|
|
int start,
|
|
int count,
|
|
int index,
|
|
int codePointOffset)
|
|
{
|
|
int len = a.length;
|
|
int end = start + count;
|
|
if (start < 0 || count < 0 || end > len || index < start || index > end)
|
|
throw new IndexOutOfBoundsException();
|
|
|
|
int numToGo = codePointOffset;
|
|
int offset = index;
|
|
int adjust = 1;
|
|
if (numToGo >= 0)
|
|
{
|
|
for (; numToGo > 0; offset++)
|
|
{
|
|
numToGo--;
|
|
if (Character.isHighSurrogate(a[offset])
|
|
&& (offset + 1) < len
|
|
&& Character.isLowSurrogate(a[offset + 1]))
|
|
offset++;
|
|
}
|
|
return offset;
|
|
}
|
|
else
|
|
{
|
|
numToGo *= -1;
|
|
for (; numToGo > 0;)
|
|
{
|
|
numToGo--;
|
|
offset--;
|
|
if (Character.isLowSurrogate(a[offset])
|
|
&& (offset - 1) >= 0
|
|
&& Character.isHighSurrogate(a[offset - 1]))
|
|
offset--;
|
|
if (offset < start)
|
|
throw new IndexOutOfBoundsException();
|
|
}
|
|
return offset;
|
|
}
|
|
|
|
}
|
|
|
|
/**
|
|
* Returns the number of Unicode code points in the specified range of the
|
|
* given CharSequence. The first char in the range is at position
|
|
* beginIndex and the last one is at position endIndex - 1. Paired
|
|
* surrogates (supplementary characters are represented by a pair of chars -
|
|
* one from the high surrogates and one from the low surrogates)
|
|
* count as just one code point.
|
|
* @param seq the CharSequence to inspect
|
|
* @param beginIndex the beginning of the range
|
|
* @param endIndex the end of the range
|
|
* @return the number of Unicode code points in the given range of the
|
|
* sequence
|
|
* @throws NullPointerException if seq is null
|
|
* @throws IndexOutOfBoundsException if beginIndex is negative, endIndex is
|
|
* larger than the length of seq, or if beginIndex is greater than endIndex.
|
|
* @since 1.5
|
|
*/
|
|
public static int codePointCount(CharSequence seq, int beginIndex,
|
|
int endIndex)
|
|
{
|
|
int len = seq.length();
|
|
if (beginIndex < 0 || endIndex > len || beginIndex > endIndex)
|
|
throw new IndexOutOfBoundsException();
|
|
|
|
int count = 0;
|
|
for (int i = beginIndex; i < endIndex; i++)
|
|
{
|
|
count++;
|
|
// If there is a pairing, count it only once.
|
|
if (isHighSurrogate(seq.charAt(i)) && (i + 1) < endIndex
|
|
&& isLowSurrogate(seq.charAt(i + 1)))
|
|
i ++;
|
|
}
|
|
return count;
|
|
}
|
|
|
|
/**
|
|
* Returns the number of Unicode code points in the specified range of the
|
|
* given char array. The first char in the range is at position
|
|
* offset and the length of the range is count. Paired surrogates
|
|
* (supplementary characters are represented by a pair of chars -
|
|
* one from the high surrogates and one from the low surrogates)
|
|
* count as just one code point.
|
|
* @param a the char array to inspect
|
|
* @param offset the beginning of the range
|
|
* @param count the length of the range
|
|
* @return the number of Unicode code points in the given range of the
|
|
* array
|
|
* @throws NullPointerException if a is null
|
|
* @throws IndexOutOfBoundsException if offset or count is negative or if
|
|
* offset + countendIndex is larger than the length of a.
|
|
* @since 1.5
|
|
*/
|
|
public static int codePointCount(char[] a, int offset,
|
|
int count)
|
|
{
|
|
int len = a.length;
|
|
int end = offset + count;
|
|
if (offset < 0 || count < 0 || end > len)
|
|
throw new IndexOutOfBoundsException();
|
|
|
|
int counter = 0;
|
|
for (int i = offset; i < end; i++)
|
|
{
|
|
counter++;
|
|
// If there is a pairing, count it only once.
|
|
if (isHighSurrogate(a[i]) && (i + 1) < end
|
|
&& isLowSurrogate(a[i + 1]))
|
|
i ++;
|
|
}
|
|
return counter;
|
|
}
|
|
|
|
/**
|
|
* Determines if a character is a Unicode letter or a Unicode digit. This
|
|
* is the combination of isLetter and isDigit.
|
|
* <br>
|
|
* letter or digit = [Lu]|[Ll]|[Lt]|[Lm]|[Lo]|[Nd]
|
|
*
|
|
* @param ch character to test
|
|
* @return true if ch is a Unicode letter or a Unicode digit, else false
|
|
* @see #isDigit(char)
|
|
* @see #isJavaIdentifierPart(char)
|
|
* @see #isJavaLetter(char)
|
|
* @see #isJavaLetterOrDigit(char)
|
|
* @see #isLetter(char)
|
|
* @see #isUnicodeIdentifierPart(char)
|
|
*/
|
|
public static boolean isLetterOrDigit(char ch)
|
|
{
|
|
return ((1 << getType(ch))
|
|
& ((1 << UPPERCASE_LETTER)
|
|
| (1 << LOWERCASE_LETTER)
|
|
| (1 << TITLECASE_LETTER)
|
|
| (1 << MODIFIER_LETTER)
|
|
| (1 << OTHER_LETTER)
|
|
| (1 << DECIMAL_DIGIT_NUMBER))) != 0;
|
|
}
|
|
|
|
/**
|
|
* Determines if a character is a Unicode letter or a Unicode digit. This
|
|
* is the combination of isLetter and isDigit. Unlike isLetterOrDigit(char),
|
|
* this method supports supplementary Unicode code points.
|
|
* <br>
|
|
* letter or digit = [Lu]|[Ll]|[Lt]|[Lm]|[Lo]|[Nd]
|
|
*
|
|
* @param codePoint character to test
|
|
* @return true if codePoint is a Unicode letter or a Unicode digit, else false
|
|
* @see #isDigit(int)
|
|
* @see #isJavaIdentifierPart(int)
|
|
* @see #isJavaLetter(int)
|
|
* @see #isJavaLetterOrDigit(int)
|
|
* @see #isLetter(int)
|
|
* @see #isUnicodeIdentifierPart(int)
|
|
* @since 1.5
|
|
*/
|
|
public static boolean isLetterOrDigit(int codePoint)
|
|
{
|
|
return ((1 << getType(codePoint)
|
|
& ((1 << UPPERCASE_LETTER)
|
|
| (1 << LOWERCASE_LETTER)
|
|
| (1 << TITLECASE_LETTER)
|
|
| (1 << MODIFIER_LETTER)
|
|
| (1 << OTHER_LETTER)
|
|
| (1 << DECIMAL_DIGIT_NUMBER))) != 0);
|
|
}
|
|
|
|
/**
|
|
* Determines if a character can start a Java identifier. This is the
|
|
* combination of isLetter, any character where getType returns
|
|
* LETTER_NUMBER, currency symbols (like '$'), and connecting punctuation
|
|
* (like '_').
|
|
*
|
|
* @param ch character to test
|
|
* @return true if ch can start a Java identifier, else false
|
|
* @deprecated Replaced by {@link #isJavaIdentifierStart(char)}
|
|
* @see #isJavaLetterOrDigit(char)
|
|
* @see #isJavaIdentifierStart(char)
|
|
* @see #isJavaIdentifierPart(char)
|
|
* @see #isLetter(char)
|
|
* @see #isLetterOrDigit(char)
|
|
* @see #isUnicodeIdentifierStart(char)
|
|
*/
|
|
public static boolean isJavaLetter(char ch)
|
|
{
|
|
return isJavaIdentifierStart(ch);
|
|
}
|
|
|
|
/**
|
|
* Determines if a character can start a Java identifier. This is the
|
|
* combination of isLetter, any character where getType returns
|
|
* LETTER_NUMBER, currency symbols (like '$'), and connecting punctuation
|
|
* (like '_'). Unlike isJavaIdentifierStart(char), this method supports
|
|
* supplementary Unicode code points.
|
|
* <br>
|
|
* Java identifier start = [Lu]|[Ll]|[Lt]|[Lm]|[Lo]|[Nl]|[Sc]|[Pc]
|
|
*
|
|
* @param codePoint character to test
|
|
* @return true if codePoint can start a Java identifier, else false
|
|
* @see #isJavaIdentifierPart(int)
|
|
* @see #isLetter(int)
|
|
* @see #isUnicodeIdentifierStart(int)
|
|
* @since 1.5
|
|
*/
|
|
public static boolean isJavaIdentifierStart(int codePoint)
|
|
{
|
|
return ((1 << getType(codePoint))
|
|
& ((1 << UPPERCASE_LETTER)
|
|
| (1 << LOWERCASE_LETTER)
|
|
| (1 << TITLECASE_LETTER)
|
|
| (1 << MODIFIER_LETTER)
|
|
| (1 << OTHER_LETTER)
|
|
| (1 << LETTER_NUMBER)
|
|
| (1 << CURRENCY_SYMBOL)
|
|
| (1 << CONNECTOR_PUNCTUATION))) != 0;
|
|
}
|
|
|
|
/**
|
|
* Determines if a character can follow the first letter in
|
|
* a Java identifier. This is the combination of isJavaLetter (isLetter,
|
|
* type of LETTER_NUMBER, currency, connecting punctuation) and digit,
|
|
* numeric letter (like Roman numerals), combining marks, non-spacing marks,
|
|
* or isIdentifierIgnorable.
|
|
*
|
|
* @param ch character to test
|
|
* @return true if ch can follow the first letter in a Java identifier
|
|
* @deprecated Replaced by {@link #isJavaIdentifierPart(char)}
|
|
* @see #isJavaLetter(char)
|
|
* @see #isJavaIdentifierStart(char)
|
|
* @see #isJavaIdentifierPart(char)
|
|
* @see #isLetter(char)
|
|
* @see #isLetterOrDigit(char)
|
|
* @see #isUnicodeIdentifierPart(char)
|
|
* @see #isIdentifierIgnorable(char)
|
|
*/
|
|
public static boolean isJavaLetterOrDigit(char ch)
|
|
{
|
|
return isJavaIdentifierPart(ch);
|
|
}
|
|
|
|
/**
|
|
* Determines if a character can start a Java identifier. This is the
|
|
* combination of isLetter, any character where getType returns
|
|
* LETTER_NUMBER, currency symbols (like '$'), and connecting punctuation
|
|
* (like '_').
|
|
* <br>
|
|
* Java identifier start = [Lu]|[Ll]|[Lt]|[Lm]|[Lo]|[Nl]|[Sc]|[Pc]
|
|
*
|
|
* @param ch character to test
|
|
* @return true if ch can start a Java identifier, else false
|
|
* @see #isJavaIdentifierPart(char)
|
|
* @see #isLetter(char)
|
|
* @see #isUnicodeIdentifierStart(char)
|
|
* @since 1.1
|
|
*/
|
|
public static boolean isJavaIdentifierStart(char ch)
|
|
{
|
|
return ((1 << getType(ch))
|
|
& ((1 << UPPERCASE_LETTER)
|
|
| (1 << LOWERCASE_LETTER)
|
|
| (1 << TITLECASE_LETTER)
|
|
| (1 << MODIFIER_LETTER)
|
|
| (1 << OTHER_LETTER)
|
|
| (1 << LETTER_NUMBER)
|
|
| (1 << CURRENCY_SYMBOL)
|
|
| (1 << CONNECTOR_PUNCTUATION))) != 0;
|
|
}
|
|
|
|
/**
|
|
* Determines if a character can follow the first letter in
|
|
* a Java identifier. This is the combination of isJavaLetter (isLetter,
|
|
* type of LETTER_NUMBER, currency, connecting punctuation) and digit,
|
|
* numeric letter (like Roman numerals), combining marks, non-spacing marks,
|
|
* or isIdentifierIgnorable.
|
|
* <br>
|
|
* Java identifier extender =
|
|
* [Lu]|[Ll]|[Lt]|[Lm]|[Lo]|[Nl]|[Sc]|[Pc]|[Mn]|[Mc]|[Nd]|[Cf]
|
|
* |U+0000-U+0008|U+000E-U+001B|U+007F-U+009F
|
|
*
|
|
* @param ch character to test
|
|
* @return true if ch can follow the first letter in a Java identifier
|
|
* @see #isIdentifierIgnorable(char)
|
|
* @see #isJavaIdentifierStart(char)
|
|
* @see #isLetterOrDigit(char)
|
|
* @see #isUnicodeIdentifierPart(char)
|
|
* @since 1.1
|
|
*/
|
|
public static boolean isJavaIdentifierPart(char ch)
|
|
{
|
|
int category = getType(ch);
|
|
return ((1 << category)
|
|
& ((1 << UPPERCASE_LETTER)
|
|
| (1 << LOWERCASE_LETTER)
|
|
| (1 << TITLECASE_LETTER)
|
|
| (1 << MODIFIER_LETTER)
|
|
| (1 << OTHER_LETTER)
|
|
| (1 << NON_SPACING_MARK)
|
|
| (1 << COMBINING_SPACING_MARK)
|
|
| (1 << DECIMAL_DIGIT_NUMBER)
|
|
| (1 << LETTER_NUMBER)
|
|
| (1 << CURRENCY_SYMBOL)
|
|
| (1 << CONNECTOR_PUNCTUATION)
|
|
| (1 << FORMAT))) != 0
|
|
|| (category == CONTROL && isIdentifierIgnorable(ch));
|
|
}
|
|
|
|
/**
|
|
* Determines if a character can follow the first letter in
|
|
* a Java identifier. This is the combination of isJavaLetter (isLetter,
|
|
* type of LETTER_NUMBER, currency, connecting punctuation) and digit,
|
|
* numeric letter (like Roman numerals), combining marks, non-spacing marks,
|
|
* or isIdentifierIgnorable. Unlike isJavaIdentifierPart(char), this method
|
|
* supports supplementary Unicode code points.
|
|
* <br>
|
|
* Java identifier extender =
|
|
* [Lu]|[Ll]|[Lt]|[Lm]|[Lo]|[Nl]|[Sc]|[Pc]|[Mn]|[Mc]|[Nd]|[Cf]
|
|
* |U+0000-U+0008|U+000E-U+001B|U+007F-U+009F
|
|
*
|
|
* @param codePoint character to test
|
|
* @return true if codePoint can follow the first letter in a Java identifier
|
|
* @see #isIdentifierIgnorable(int)
|
|
* @see #isJavaIdentifierStart(int)
|
|
* @see #isLetterOrDigit(int)
|
|
* @see #isUnicodeIdentifierPart(int)
|
|
* @since 1.5
|
|
*/
|
|
public static boolean isJavaIdentifierPart(int codePoint)
|
|
{
|
|
int category = getType(codePoint);
|
|
return ((1 << category)
|
|
& ((1 << UPPERCASE_LETTER)
|
|
| (1 << LOWERCASE_LETTER)
|
|
| (1 << TITLECASE_LETTER)
|
|
| (1 << MODIFIER_LETTER)
|
|
| (1 << OTHER_LETTER)
|
|
| (1 << NON_SPACING_MARK)
|
|
| (1 << COMBINING_SPACING_MARK)
|
|
| (1 << DECIMAL_DIGIT_NUMBER)
|
|
| (1 << LETTER_NUMBER)
|
|
| (1 << CURRENCY_SYMBOL)
|
|
| (1 << CONNECTOR_PUNCTUATION)
|
|
| (1 << FORMAT))) != 0
|
|
|| (category == CONTROL && isIdentifierIgnorable(codePoint));
|
|
}
|
|
|
|
/**
|
|
* Determines if a character can start a Unicode identifier. Only
|
|
* letters can start a Unicode identifier, but this includes characters
|
|
* in LETTER_NUMBER.
|
|
* <br>
|
|
* Unicode identifier start = [Lu]|[Ll]|[Lt]|[Lm]|[Lo]|[Nl]
|
|
*
|
|
* @param ch character to test
|
|
* @return true if ch can start a Unicode identifier, else false
|
|
* @see #isJavaIdentifierStart(char)
|
|
* @see #isLetter(char)
|
|
* @see #isUnicodeIdentifierPart(char)
|
|
* @since 1.1
|
|
*/
|
|
public static boolean isUnicodeIdentifierStart(char ch)
|
|
{
|
|
return ((1 << getType(ch))
|
|
& ((1 << UPPERCASE_LETTER)
|
|
| (1 << LOWERCASE_LETTER)
|
|
| (1 << TITLECASE_LETTER)
|
|
| (1 << MODIFIER_LETTER)
|
|
| (1 << OTHER_LETTER)
|
|
| (1 << LETTER_NUMBER))) != 0;
|
|
}
|
|
|
|
/**
|
|
* Determines if a character can start a Unicode identifier. Only
|
|
* letters can start a Unicode identifier, but this includes characters
|
|
* in LETTER_NUMBER. Unlike isUnicodeIdentifierStart(char), this method
|
|
* supports supplementary Unicode code points.
|
|
* <br>
|
|
* Unicode identifier start = [Lu]|[Ll]|[Lt]|[Lm]|[Lo]|[Nl]
|
|
*
|
|
* @param codePoint character to test
|
|
* @return true if codePoint can start a Unicode identifier, else false
|
|
* @see #isJavaIdentifierStart(int)
|
|
* @see #isLetter(int)
|
|
* @see #isUnicodeIdentifierPart(int)
|
|
* @since 1.5
|
|
*/
|
|
public static boolean isUnicodeIdentifierStart(int codePoint)
|
|
{
|
|
return ((1 << getType(codePoint))
|
|
& ((1 << UPPERCASE_LETTER)
|
|
| (1 << LOWERCASE_LETTER)
|
|
| (1 << TITLECASE_LETTER)
|
|
| (1 << MODIFIER_LETTER)
|
|
| (1 << OTHER_LETTER)
|
|
| (1 << LETTER_NUMBER))) != 0;
|
|
}
|
|
|
|
/**
|
|
* Determines if a character can follow the first letter in
|
|
* a Unicode identifier. This includes letters, connecting punctuation,
|
|
* digits, numeric letters, combining marks, non-spacing marks, and
|
|
* isIdentifierIgnorable.
|
|
* <br>
|
|
* Unicode identifier extender =
|
|
* [Lu]|[Ll]|[Lt]|[Lm]|[Lo]|[Nl]|[Mn]|[Mc]|[Nd]|[Pc]|[Cf]|
|
|
* |U+0000-U+0008|U+000E-U+001B|U+007F-U+009F
|
|
*
|
|
* @param ch character to test
|
|
* @return true if ch can follow the first letter in a Unicode identifier
|
|
* @see #isIdentifierIgnorable(char)
|
|
* @see #isJavaIdentifierPart(char)
|
|
* @see #isLetterOrDigit(char)
|
|
* @see #isUnicodeIdentifierStart(char)
|
|
* @since 1.1
|
|
*/
|
|
public static boolean isUnicodeIdentifierPart(char ch)
|
|
{
|
|
int category = getType(ch);
|
|
return ((1 << category)
|
|
& ((1 << UPPERCASE_LETTER)
|
|
| (1 << LOWERCASE_LETTER)
|
|
| (1 << TITLECASE_LETTER)
|
|
| (1 << MODIFIER_LETTER)
|
|
| (1 << OTHER_LETTER)
|
|
| (1 << NON_SPACING_MARK)
|
|
| (1 << COMBINING_SPACING_MARK)
|
|
| (1 << DECIMAL_DIGIT_NUMBER)
|
|
| (1 << LETTER_NUMBER)
|
|
| (1 << CONNECTOR_PUNCTUATION)
|
|
| (1 << FORMAT))) != 0
|
|
|| (category == CONTROL && isIdentifierIgnorable(ch));
|
|
}
|
|
|
|
/**
|
|
* Determines if a character can follow the first letter in
|
|
* a Unicode identifier. This includes letters, connecting punctuation,
|
|
* digits, numeric letters, combining marks, non-spacing marks, and
|
|
* isIdentifierIgnorable. Unlike isUnicodeIdentifierPart(char), this method
|
|
* supports supplementary Unicode code points.
|
|
* <br>
|
|
* Unicode identifier extender =
|
|
* [Lu]|[Ll]|[Lt]|[Lm]|[Lo]|[Nl]|[Mn]|[Mc]|[Nd]|[Pc]|[Cf]|
|
|
* |U+0000-U+0008|U+000E-U+001B|U+007F-U+009F
|
|
*
|
|
* @param codePoint character to test
|
|
* @return true if codePoint can follow the first letter in a Unicode
|
|
* identifier
|
|
* @see #isIdentifierIgnorable(int)
|
|
* @see #isJavaIdentifierPart(int)
|
|
* @see #isLetterOrDigit(int)
|
|
* @see #isUnicodeIdentifierStart(int)
|
|
* @since 1.5
|
|
*/
|
|
public static boolean isUnicodeIdentifierPart(int codePoint)
|
|
{
|
|
int category = getType(codePoint);
|
|
return ((1 << category)
|
|
& ((1 << UPPERCASE_LETTER)
|
|
| (1 << LOWERCASE_LETTER)
|
|
| (1 << TITLECASE_LETTER)
|
|
| (1 << MODIFIER_LETTER)
|
|
| (1 << OTHER_LETTER)
|
|
| (1 << NON_SPACING_MARK)
|
|
| (1 << COMBINING_SPACING_MARK)
|
|
| (1 << DECIMAL_DIGIT_NUMBER)
|
|
| (1 << LETTER_NUMBER)
|
|
| (1 << CONNECTOR_PUNCTUATION)
|
|
| (1 << FORMAT))) != 0
|
|
|| (category == CONTROL && isIdentifierIgnorable(codePoint));
|
|
}
|
|
|
|
/**
|
|
* Determines if a character is ignorable in a Unicode identifier. This
|
|
* includes the non-whitespace ISO control characters (<code>'\u0000'</code>
|
|
* through <code>'\u0008'</code>, <code>'\u000E'</code> through
|
|
* <code>'\u001B'</code>, and <code>'\u007F'</code> through
|
|
* <code>'\u009F'</code>), and FORMAT characters.
|
|
* <br>
|
|
* Unicode identifier ignorable = [Cf]|U+0000-U+0008|U+000E-U+001B
|
|
* |U+007F-U+009F
|
|
*
|
|
* @param ch character to test
|
|
* @return true if ch is ignorable in a Unicode or Java identifier
|
|
* @see #isJavaIdentifierPart(char)
|
|
* @see #isUnicodeIdentifierPart(char)
|
|
* @since 1.1
|
|
*/
|
|
public static boolean isIdentifierIgnorable(char ch)
|
|
{
|
|
return (ch <= '\u009F' && (ch < '\t' || ch >= '\u007F'
|
|
|| (ch <= '\u001B' && ch >= '\u000E')))
|
|
|| getType(ch) == FORMAT;
|
|
}
|
|
|
|
/**
|
|
* Determines if a character is ignorable in a Unicode identifier. This
|
|
* includes the non-whitespace ISO control characters (<code>'\u0000'</code>
|
|
* through <code>'\u0008'</code>, <code>'\u000E'</code> through
|
|
* <code>'\u001B'</code>, and <code>'\u007F'</code> through
|
|
* <code>'\u009F'</code>), and FORMAT characters. Unlike
|
|
* isIdentifierIgnorable(char), this method supports supplementary Unicode
|
|
* code points.
|
|
* <br>
|
|
* Unicode identifier ignorable = [Cf]|U+0000-U+0008|U+000E-U+001B
|
|
* |U+007F-U+009F
|
|
*
|
|
* @param codePoint character to test
|
|
* @return true if codePoint is ignorable in a Unicode or Java identifier
|
|
* @see #isJavaIdentifierPart(int)
|
|
* @see #isUnicodeIdentifierPart(int)
|
|
* @since 1.5
|
|
*/
|
|
public static boolean isIdentifierIgnorable(int codePoint)
|
|
{
|
|
return ((codePoint >= 0 && codePoint <= 0x0008)
|
|
|| (codePoint >= 0x000E && codePoint <= 0x001B)
|
|
|| (codePoint >= 0x007F && codePoint <= 0x009F)
|
|
|| getType(codePoint) == FORMAT);
|
|
}
|
|
|
|
/**
|
|
* Converts a Unicode character into its lowercase equivalent mapping.
|
|
* If a mapping does not exist, then the character passed is returned.
|
|
* Note that isLowerCase(toLowerCase(ch)) does not always return true.
|
|
*
|
|
* @param ch character to convert to lowercase
|
|
* @return lowercase mapping of ch, or ch if lowercase mapping does
|
|
* not exist
|
|
* @see #isLowerCase(char)
|
|
* @see #isUpperCase(char)
|
|
* @see #toTitleCase(char)
|
|
* @see #toUpperCase(char)
|
|
*/
|
|
public static native char toLowerCase(char ch);
|
|
|
|
/**
|
|
* Converts a Unicode character into its lowercase equivalent mapping.
|
|
* If a mapping does not exist, then the character passed is returned.
|
|
* Note that isLowerCase(toLowerCase(codePoint)) does not always return true.
|
|
* Unlike toLowerCase(char), this method supports supplementary Unicode
|
|
* code points.
|
|
*
|
|
* @param codePoint character to convert to lowercase
|
|
* @return lowercase mapping of codePoint, or codePoint if lowercase
|
|
* mapping does not exist
|
|
* @see #isLowerCase(int)
|
|
* @see #isUpperCase(int)
|
|
* @see #toTitleCase(int)
|
|
* @see #toUpperCase(int)
|
|
* @since 1.5
|
|
*/
|
|
public static native int toLowerCase(int codePoint);
|
|
|
|
/**
|
|
* Converts a Unicode character into its uppercase equivalent mapping.
|
|
* If a mapping does not exist, then the character passed is returned.
|
|
* Note that isUpperCase(toUpperCase(ch)) does not always return true.
|
|
*
|
|
* @param ch character to convert to uppercase
|
|
* @return uppercase mapping of ch, or ch if uppercase mapping does
|
|
* not exist
|
|
* @see #isLowerCase(char)
|
|
* @see #isUpperCase(char)
|
|
* @see #toLowerCase(char)
|
|
* @see #toTitleCase(char)
|
|
*/
|
|
public static native char toUpperCase(char ch);
|
|
|
|
/**
|
|
* Converts a Unicode character into its uppercase equivalent mapping.
|
|
* If a mapping does not exist, then the character passed is returned.
|
|
* Note that isUpperCase(toUpperCase(codePoint)) does not always return true.
|
|
* Unlike toUpperCase(char), this method supports supplementary
|
|
* Unicode code points.
|
|
*
|
|
* @param codePoint character to convert to uppercase
|
|
* @return uppercase mapping of codePoint, or codePoint if uppercase
|
|
* mapping does not exist
|
|
* @see #isLowerCase(int)
|
|
* @see #isUpperCase(int)
|
|
* @see #toLowerCase(int)
|
|
* @see #toTitleCase(int)
|
|
* @since 1.5
|
|
*/
|
|
public static native int toUpperCase(int codePoint);
|
|
|
|
/**
|
|
* Converts a Unicode character into its titlecase equivalent mapping.
|
|
* If a mapping does not exist, then the character passed is returned.
|
|
* Note that isTitleCase(toTitleCase(ch)) does not always return true.
|
|
*
|
|
* @param ch character to convert to titlecase
|
|
* @return titlecase mapping of ch, or ch if titlecase mapping does
|
|
* not exist
|
|
* @see #isTitleCase(char)
|
|
* @see #toLowerCase(char)
|
|
* @see #toUpperCase(char)
|
|
*/
|
|
public static native char toTitleCase(char ch);
|
|
|
|
/**
|
|
* Converts a Unicode character into its titlecase equivalent mapping.
|
|
* If a mapping does not exist, then the character passed is returned.
|
|
* Note that isTitleCase(toTitleCase(codePoint)) does not always return true.
|
|
* Unlike toTitleCase(char), this method supports supplementary
|
|
* Unicode code points.
|
|
*
|
|
* @param codePoint character to convert to titlecase
|
|
* @return titlecase mapping of codePoint, or codePoint if titlecase
|
|
* mapping does not exist
|
|
* @see #isTitleCase(int)
|
|
* @see #toLowerCase(int)
|
|
* @see #toUpperCase(int)
|
|
* @since 1.5
|
|
*/
|
|
public static native int toTitleCase(int codePoint);
|
|
|
|
/**
|
|
* Converts a character into a digit of the specified radix. If the radix
|
|
* exceeds MIN_RADIX or MAX_RADIX, or if the result of getNumericValue(ch)
|
|
* exceeds the radix, or if ch is not a decimal digit or in the case
|
|
* insensitive set of 'a'-'z', the result is -1.
|
|
* <br>
|
|
* character argument boundary = [Nd]|U+0041-U+005A|U+0061-U+007A
|
|
* |U+FF21-U+FF3A|U+FF41-U+FF5A
|
|
*
|
|
* @param ch character to convert into a digit
|
|
* @param radix radix in which ch is a digit
|
|
* @return digit which ch represents in radix, or -1 not a valid digit
|
|
* @see #MIN_RADIX
|
|
* @see #MAX_RADIX
|
|
* @see #forDigit(int, int)
|
|
* @see #isDigit(char)
|
|
* @see #getNumericValue(char)
|
|
*/
|
|
public static native int digit(char ch, int radix);
|
|
|
|
/**
|
|
* Converts a character into a digit of the specified radix. If the radix
|
|
* exceeds MIN_RADIX or MAX_RADIX, or if the result of getNumericValue(int)
|
|
* exceeds the radix, or if codePoint is not a decimal digit or in the case
|
|
* insensitive set of 'a'-'z', the result is -1. Unlike digit(char, int),
|
|
* this method supports supplementary Unicode code points.
|
|
* <br>
|
|
* character argument boundary = [Nd]|U+0041-U+005A|U+0061-U+007A
|
|
* |U+FF21-U+FF3A|U+FF41-U+FF5A
|
|
*
|
|
* @param codePoint character to convert into a digit
|
|
* @param radix radix in which codePoint is a digit
|
|
* @return digit which codePoint represents in radix, or -1 not a valid digit
|
|
* @see #MIN_RADIX
|
|
* @see #MAX_RADIX
|
|
* @see #forDigit(int, int)
|
|
* @see #isDigit(int)
|
|
* @see #getNumericValue(int)
|
|
* @since 1.5
|
|
*/
|
|
public static native int digit(int codePoint, int radix);
|
|
|
|
/**
|
|
* Returns the Unicode numeric value property of a character. For example,
|
|
* <code>'\\u216C'</code> (the Roman numeral fifty) returns 50.
|
|
*
|
|
* <p>This method also returns values for the letters A through Z, (not
|
|
* specified by Unicode), in these ranges: <code>'\u0041'</code>
|
|
* through <code>'\u005A'</code> (uppercase); <code>'\u0061'</code>
|
|
* through <code>'\u007A'</code> (lowercase); and <code>'\uFF21'</code>
|
|
* through <code>'\uFF3A'</code>, <code>'\uFF41'</code> through
|
|
* <code>'\uFF5A'</code> (full width variants).
|
|
*
|
|
* <p>If the character lacks a numeric value property, -1 is returned.
|
|
* If the character has a numeric value property which is not representable
|
|
* as a nonnegative integer, such as a fraction, -2 is returned.
|
|
*
|
|
* character argument boundary = [Nd]|[Nl]|[No]|U+0041-U+005A|U+0061-U+007A
|
|
* |U+FF21-U+FF3A|U+FF41-U+FF5A
|
|
*
|
|
* @param ch character from which the numeric value property will
|
|
* be retrieved
|
|
* @return the numeric value property of ch, or -1 if it does not exist, or
|
|
* -2 if it is not representable as a nonnegative integer
|
|
* @see #forDigit(int, int)
|
|
* @see #digit(char, int)
|
|
* @see #isDigit(char)
|
|
* @since 1.1
|
|
*/
|
|
public static native int getNumericValue(char ch);
|
|
|
|
/**
|
|
* Returns the Unicode numeric value property of a character. For example,
|
|
* <code>'\\u216C'</code> (the Roman numeral fifty) returns 50.
|
|
*
|
|
* <p>This method also returns values for the letters A through Z, (not
|
|
* specified by Unicode), in these ranges: <code>'\u0041'</code>
|
|
* through <code>'\u005A'</code> (uppercase); <code>'\u0061'</code>
|
|
* through <code>'\u007A'</code> (lowercase); and <code>'\uFF21'</code>
|
|
* through <code>'\uFF3A'</code>, <code>'\uFF41'</code> through
|
|
* <code>'\uFF5A'</code> (full width variants).
|
|
*
|
|
* <p>If the character lacks a numeric value property, -1 is returned.
|
|
* If the character has a numeric value property which is not representable
|
|
* as a nonnegative integer, such as a fraction, -2 is returned.
|
|
*
|
|
* Unlike getNumericValue(char), this method supports supplementary Unicode
|
|
* code points.
|
|
*
|
|
* character argument boundary = [Nd]|[Nl]|[No]|U+0041-U+005A|U+0061-U+007A
|
|
* |U+FF21-U+FF3A|U+FF41-U+FF5A
|
|
*
|
|
* @param codePoint character from which the numeric value property will
|
|
* be retrieved
|
|
* @return the numeric value property of codePoint, or -1 if it does not
|
|
* exist, or -2 if it is not representable as a nonnegative integer
|
|
* @see #forDigit(int, int)
|
|
* @see #digit(int, int)
|
|
* @see #isDigit(int)
|
|
* @since 1.5
|
|
*/
|
|
public static native int getNumericValue(int codePoint);
|
|
|
|
/**
|
|
* Determines if a character is a ISO-LATIN-1 space. This is only the five
|
|
* characters <code>'\t'</code>, <code>'\n'</code>, <code>'\f'</code>,
|
|
* <code>'\r'</code>, and <code>' '</code>.
|
|
* <br>
|
|
* Java space = U+0020|U+0009|U+000A|U+000C|U+000D
|
|
*
|
|
* @param ch character to test
|
|
* @return true if ch is a space, else false
|
|
* @deprecated Replaced by {@link #isWhitespace(char)}
|
|
* @see #isSpaceChar(char)
|
|
* @see #isWhitespace(char)
|
|
*/
|
|
public static boolean isSpace(char ch)
|
|
{
|
|
// Performing the subtraction up front alleviates need to compare longs.
|
|
return ch-- <= ' ' && ((1 << ch)
|
|
& ((1 << (' ' - 1))
|
|
| (1 << ('\t' - 1))
|
|
| (1 << ('\n' - 1))
|
|
| (1 << ('\r' - 1))
|
|
| (1 << ('\f' - 1)))) != 0;
|
|
}
|
|
|
|
/**
|
|
* Determines if a character is a Unicode space character. This includes
|
|
* SPACE_SEPARATOR, LINE_SEPARATOR, and PARAGRAPH_SEPARATOR.
|
|
* <br>
|
|
* Unicode space = [Zs]|[Zp]|[Zl]
|
|
*
|
|
* @param ch character to test
|
|
* @return true if ch is a Unicode space, else false
|
|
* @see #isWhitespace(char)
|
|
* @since 1.1
|
|
*/
|
|
public static boolean isSpaceChar(char ch)
|
|
{
|
|
return ((1 << getType(ch))
|
|
& ((1 << SPACE_SEPARATOR)
|
|
| (1 << LINE_SEPARATOR)
|
|
| (1 << PARAGRAPH_SEPARATOR))) != 0;
|
|
}
|
|
|
|
/**
|
|
* Determines if a character is a Unicode space character. This includes
|
|
* SPACE_SEPARATOR, LINE_SEPARATOR, and PARAGRAPH_SEPARATOR. Unlike
|
|
* isSpaceChar(char), this method supports supplementary Unicode code points.
|
|
* <br>
|
|
* Unicode space = [Zs]|[Zp]|[Zl]
|
|
*
|
|
* @param codePoint character to test
|
|
* @return true if codePoint is a Unicode space, else false
|
|
* @see #isWhitespace(int)
|
|
* @since 1.5
|
|
*/
|
|
public static boolean isSpaceChar(int codePoint)
|
|
{
|
|
return ((1 << getType(codePoint))
|
|
& ((1 << SPACE_SEPARATOR)
|
|
| (1 << LINE_SEPARATOR)
|
|
| (1 << PARAGRAPH_SEPARATOR))) != 0;
|
|
}
|
|
|
|
/**
|
|
* Determines if a character is Java whitespace. This includes Unicode
|
|
* space characters (SPACE_SEPARATOR, LINE_SEPARATOR, and
|
|
* PARAGRAPH_SEPARATOR) except the non-breaking spaces
|
|
* (<code>'\u00A0'</code>, <code>'\u2007'</code>, and <code>'\u202F'</code>);
|
|
* and these characters: <code>'\u0009'</code>, <code>'\u000A'</code>,
|
|
* <code>'\u000B'</code>, <code>'\u000C'</code>, <code>'\u000D'</code>,
|
|
* <code>'\u001C'</code>, <code>'\u001D'</code>, <code>'\u001E'</code>,
|
|
* and <code>'\u001F'</code>.
|
|
* <br>
|
|
* Java whitespace = ([Zs] not Nb)|[Zl]|[Zp]|U+0009-U+000D|U+001C-U+001F
|
|
*
|
|
* @param ch character to test
|
|
* @return true if ch is Java whitespace, else false
|
|
* @see #isSpaceChar(char)
|
|
* @since 1.1
|
|
*/
|
|
public static boolean isWhitespace(char ch)
|
|
{
|
|
int attr = readChar(ch);
|
|
return ((((1 << (attr & TYPE_MASK))
|
|
& ((1 << SPACE_SEPARATOR)
|
|
| (1 << LINE_SEPARATOR)
|
|
| (1 << PARAGRAPH_SEPARATOR))) != 0)
|
|
&& (attr & NO_BREAK_MASK) == 0)
|
|
|| (ch <= '\u001F' && ((1 << ch)
|
|
& ((1 << '\t')
|
|
| (1 << '\n')
|
|
| (1 << '\u000B')
|
|
| (1 << '\u000C')
|
|
| (1 << '\r')
|
|
| (1 << '\u001C')
|
|
| (1 << '\u001D')
|
|
| (1 << '\u001E')
|
|
| (1 << '\u001F'))) != 0);
|
|
}
|
|
|
|
/**
|
|
* Determines if a character is Java whitespace. This includes Unicode
|
|
* space characters (SPACE_SEPARATOR, LINE_SEPARATOR, and
|
|
* PARAGRAPH_SEPARATOR) except the non-breaking spaces
|
|
* (<code>'\u00A0'</code>, <code>'\u2007'</code>, and <code>'\u202F'</code>);
|
|
* and these characters: <code>'\u0009'</code>, <code>'\u000A'</code>,
|
|
* <code>'\u000B'</code>, <code>'\u000C'</code>, <code>'\u000D'</code>,
|
|
* <code>'\u001C'</code>, <code>'\u001D'</code>, <code>'\u001E'</code>,
|
|
* and <code>'\u001F'</code>. Unlike isWhitespace(char), this method
|
|
* supports supplementary Unicode code points.
|
|
* <br>
|
|
* Java whitespace = ([Zs] not Nb)|[Zl]|[Zp]|U+0009-U+000D|U+001C-U+001F
|
|
*
|
|
* @param codePoint character to test
|
|
* @return true if codePoint is Java whitespace, else false
|
|
* @see #isSpaceChar(int)
|
|
* @since 1.5
|
|
*/
|
|
public static boolean isWhitespace(int codePoint)
|
|
{
|
|
int plane = codePoint >>> 16;
|
|
if (plane > 2 && plane != 14)
|
|
return false;
|
|
int attr = readCodePoint(codePoint);
|
|
return ((((1 << (attr & TYPE_MASK))
|
|
& ((1 << SPACE_SEPARATOR)
|
|
| (1 << LINE_SEPARATOR)
|
|
| (1 << PARAGRAPH_SEPARATOR))) != 0)
|
|
&& (attr & NO_BREAK_MASK) == 0)
|
|
|| (codePoint <= '\u001F' && ((1 << codePoint)
|
|
& ((1 << '\t')
|
|
| (1 << '\n')
|
|
| (1 << '\u000B')
|
|
| (1 << '\u000C')
|
|
| (1 << '\r')
|
|
| (1 << '\u001C')
|
|
| (1 << '\u001D')
|
|
| (1 << '\u001E')
|
|
| (1 << '\u001F'))) != 0);
|
|
}
|
|
|
|
/**
|
|
* Determines if a character has the ISO Control property.
|
|
* <br>
|
|
* ISO Control = [Cc]
|
|
*
|
|
* @param ch character to test
|
|
* @return true if ch is an ISO Control character, else false
|
|
* @see #isSpaceChar(char)
|
|
* @see #isWhitespace(char)
|
|
* @since 1.1
|
|
*/
|
|
public static boolean isISOControl(char ch)
|
|
{
|
|
return getType(ch) == CONTROL;
|
|
}
|
|
|
|
/**
|
|
* Determines if a character has the ISO Control property. Unlike
|
|
* isISOControl(char), this method supports supplementary unicode
|
|
* code points.
|
|
* <br>
|
|
* ISO Control = [Cc]
|
|
*
|
|
* @param codePoint character to test
|
|
* @return true if codePoint is an ISO Control character, else false
|
|
* @see #isSpaceChar(int)
|
|
* @see #isWhitespace(int)
|
|
* @since 1.5
|
|
*/
|
|
public static boolean isISOControl(int codePoint)
|
|
{
|
|
return getType(codePoint) == CONTROL;
|
|
}
|
|
|
|
/**
|
|
* Returns the Unicode general category property of a character.
|
|
*
|
|
* @param ch character from which the general category property will
|
|
* be retrieved
|
|
* @return the character category property of ch as an integer
|
|
* @see #UNASSIGNED
|
|
* @see #UPPERCASE_LETTER
|
|
* @see #LOWERCASE_LETTER
|
|
* @see #TITLECASE_LETTER
|
|
* @see #MODIFIER_LETTER
|
|
* @see #OTHER_LETTER
|
|
* @see #NON_SPACING_MARK
|
|
* @see #ENCLOSING_MARK
|
|
* @see #COMBINING_SPACING_MARK
|
|
* @see #DECIMAL_DIGIT_NUMBER
|
|
* @see #LETTER_NUMBER
|
|
* @see #OTHER_NUMBER
|
|
* @see #SPACE_SEPARATOR
|
|
* @see #LINE_SEPARATOR
|
|
* @see #PARAGRAPH_SEPARATOR
|
|
* @see #CONTROL
|
|
* @see #FORMAT
|
|
* @see #PRIVATE_USE
|
|
* @see #SURROGATE
|
|
* @see #DASH_PUNCTUATION
|
|
* @see #START_PUNCTUATION
|
|
* @see #END_PUNCTUATION
|
|
* @see #CONNECTOR_PUNCTUATION
|
|
* @see #OTHER_PUNCTUATION
|
|
* @see #MATH_SYMBOL
|
|
* @see #CURRENCY_SYMBOL
|
|
* @see #MODIFIER_SYMBOL
|
|
* @see #INITIAL_QUOTE_PUNCTUATION
|
|
* @see #FINAL_QUOTE_PUNCTUATION
|
|
* @since 1.1
|
|
*/
|
|
public static native int getType(char ch);
|
|
|
|
/**
|
|
* Returns the Unicode general category property of a character. Supports
|
|
* supplementary Unicode code points.
|
|
*
|
|
* @param codePoint character from which the general category property will
|
|
* be retrieved
|
|
* @return the character category property of codePoint as an integer
|
|
* @see #UNASSIGNED
|
|
* @see #UPPERCASE_LETTER
|
|
* @see #LOWERCASE_LETTER
|
|
* @see #TITLECASE_LETTER
|
|
* @see #MODIFIER_LETTER
|
|
* @see #OTHER_LETTER
|
|
* @see #NON_SPACING_MARK
|
|
* @see #ENCLOSING_MARK
|
|
* @see #COMBINING_SPACING_MARK
|
|
* @see #DECIMAL_DIGIT_NUMBER
|
|
* @see #LETTER_NUMBER
|
|
* @see #OTHER_NUMBER
|
|
* @see #SPACE_SEPARATOR
|
|
* @see #LINE_SEPARATOR
|
|
* @see #PARAGRAPH_SEPARATOR
|
|
* @see #CONTROL
|
|
* @see #FORMAT
|
|
* @see #PRIVATE_USE
|
|
* @see #SURROGATE
|
|
* @see #DASH_PUNCTUATION
|
|
* @see #START_PUNCTUATION
|
|
* @see #END_PUNCTUATION
|
|
* @see #CONNECTOR_PUNCTUATION
|
|
* @see #OTHER_PUNCTUATION
|
|
* @see #MATH_SYMBOL
|
|
* @see #CURRENCY_SYMBOL
|
|
* @see #MODIFIER_SYMBOL
|
|
* @see #INITIAL_QUOTE_PUNCTUATION
|
|
* @see #FINAL_QUOTE_PUNCTUATION
|
|
* @since 1.5
|
|
*/
|
|
public static native int getType(int codePoint);
|
|
|
|
/**
|
|
* Converts a digit into a character which represents that digit
|
|
* in a specified radix. If the radix exceeds MIN_RADIX or MAX_RADIX,
|
|
* or the digit exceeds the radix, then the null character <code>'\0'</code>
|
|
* is returned. Otherwise the return value is in '0'-'9' and 'a'-'z'.
|
|
* <br>
|
|
* return value boundary = U+0030-U+0039|U+0061-U+007A
|
|
*
|
|
* @param digit digit to be converted into a character
|
|
* @param radix radix of digit
|
|
* @return character representing digit in radix, or '\0'
|
|
* @see #MIN_RADIX
|
|
* @see #MAX_RADIX
|
|
* @see #digit(char, int)
|
|
*/
|
|
public static char forDigit(int digit, int radix)
|
|
{
|
|
if (radix < MIN_RADIX || radix > MAX_RADIX
|
|
|| digit < 0 || digit >= radix)
|
|
return '\0';
|
|
return (char) (digit < 10 ? ('0' + digit) : ('a' - 10 + digit));
|
|
}
|
|
|
|
/**
|
|
* Returns the Unicode directionality property of the character. This
|
|
* is used in the visual ordering of text.
|
|
*
|
|
* @param ch the character to look up
|
|
* @return the directionality constant, or DIRECTIONALITY_UNDEFINED
|
|
* @see #DIRECTIONALITY_UNDEFINED
|
|
* @see #DIRECTIONALITY_LEFT_TO_RIGHT
|
|
* @see #DIRECTIONALITY_RIGHT_TO_LEFT
|
|
* @see #DIRECTIONALITY_RIGHT_TO_LEFT_ARABIC
|
|
* @see #DIRECTIONALITY_EUROPEAN_NUMBER
|
|
* @see #DIRECTIONALITY_EUROPEAN_NUMBER_SEPARATOR
|
|
* @see #DIRECTIONALITY_EUROPEAN_NUMBER_TERMINATOR
|
|
* @see #DIRECTIONALITY_ARABIC_NUMBER
|
|
* @see #DIRECTIONALITY_COMMON_NUMBER_SEPARATOR
|
|
* @see #DIRECTIONALITY_NONSPACING_MARK
|
|
* @see #DIRECTIONALITY_BOUNDARY_NEUTRAL
|
|
* @see #DIRECTIONALITY_PARAGRAPH_SEPARATOR
|
|
* @see #DIRECTIONALITY_SEGMENT_SEPARATOR
|
|
* @see #DIRECTIONALITY_WHITESPACE
|
|
* @see #DIRECTIONALITY_OTHER_NEUTRALS
|
|
* @see #DIRECTIONALITY_LEFT_TO_RIGHT_EMBEDDING
|
|
* @see #DIRECTIONALITY_LEFT_TO_RIGHT_OVERRIDE
|
|
* @see #DIRECTIONALITY_RIGHT_TO_LEFT_EMBEDDING
|
|
* @see #DIRECTIONALITY_RIGHT_TO_LEFT_OVERRIDE
|
|
* @see #DIRECTIONALITY_POP_DIRECTIONAL_FORMAT
|
|
* @since 1.4
|
|
*/
|
|
public static native byte getDirectionality(char ch);
|
|
|
|
/**
|
|
* Returns the Unicode directionality property of the character. This
|
|
* is used in the visual ordering of text. Unlike getDirectionality(char),
|
|
* this method supports supplementary Unicode code points.
|
|
*
|
|
* @param codePoint the character to look up
|
|
* @return the directionality constant, or DIRECTIONALITY_UNDEFINED
|
|
* @see #DIRECTIONALITY_UNDEFINED
|
|
* @see #DIRECTIONALITY_LEFT_TO_RIGHT
|
|
* @see #DIRECTIONALITY_RIGHT_TO_LEFT
|
|
* @see #DIRECTIONALITY_RIGHT_TO_LEFT_ARABIC
|
|
* @see #DIRECTIONALITY_EUROPEAN_NUMBER
|
|
* @see #DIRECTIONALITY_EUROPEAN_NUMBER_SEPARATOR
|
|
* @see #DIRECTIONALITY_EUROPEAN_NUMBER_TERMINATOR
|
|
* @see #DIRECTIONALITY_ARABIC_NUMBER
|
|
* @see #DIRECTIONALITY_COMMON_NUMBER_SEPARATOR
|
|
* @see #DIRECTIONALITY_NONSPACING_MARK
|
|
* @see #DIRECTIONALITY_BOUNDARY_NEUTRAL
|
|
* @see #DIRECTIONALITY_PARAGRAPH_SEPARATOR
|
|
* @see #DIRECTIONALITY_SEGMENT_SEPARATOR
|
|
* @see #DIRECTIONALITY_WHITESPACE
|
|
* @see #DIRECTIONALITY_OTHER_NEUTRALS
|
|
* @see #DIRECTIONALITY_LEFT_TO_RIGHT_EMBEDDING
|
|
* @see #DIRECTIONALITY_LEFT_TO_RIGHT_OVERRIDE
|
|
* @see #DIRECTIONALITY_RIGHT_TO_LEFT_EMBEDDING
|
|
* @see #DIRECTIONALITY_RIGHT_TO_LEFT_OVERRIDE
|
|
* @see #DIRECTIONALITY_POP_DIRECTIONAL_FORMAT
|
|
* @since 1.5
|
|
*/
|
|
public static native byte getDirectionality(int codePoint);
|
|
|
|
/**
|
|
* Determines whether the character is mirrored according to Unicode. For
|
|
* example, <code>\u0028</code> (LEFT PARENTHESIS) appears as '(' in
|
|
* left-to-right text, but ')' in right-to-left text.
|
|
*
|
|
* @param ch the character to look up
|
|
* @return true if the character is mirrored
|
|
* @since 1.4
|
|
*/
|
|
public static boolean isMirrored(char ch)
|
|
{
|
|
return (readChar(ch) & MIRROR_MASK) != 0;
|
|
}
|
|
|
|
/**
|
|
* Determines whether the character is mirrored according to Unicode. For
|
|
* example, <code>\u0028</code> (LEFT PARENTHESIS) appears as '(' in
|
|
* left-to-right text, but ')' in right-to-left text. Unlike
|
|
* isMirrored(char), this method supports supplementary Unicode code points.
|
|
*
|
|
* @param codePoint the character to look up
|
|
* @return true if the character is mirrored
|
|
* @since 1.5
|
|
*/
|
|
public static boolean isMirrored(int codePoint)
|
|
{
|
|
int plane = codePoint >>> 16;
|
|
if (plane > 2 && plane != 14)
|
|
return false;
|
|
return (readCodePoint(codePoint) & MIRROR_MASK) != 0;
|
|
}
|
|
|
|
/**
|
|
* Compares another Character to this Character, numerically.
|
|
*
|
|
* @param anotherCharacter Character to compare with this Character
|
|
* @return a negative integer if this Character is less than
|
|
* anotherCharacter, zero if this Character is equal, and
|
|
* a positive integer if this Character is greater
|
|
* @throws NullPointerException if anotherCharacter is null
|
|
* @since 1.2
|
|
*/
|
|
public int compareTo(Character anotherCharacter)
|
|
{
|
|
return value - anotherCharacter.value;
|
|
}
|
|
|
|
/**
|
|
* Returns an <code>Character</code> object wrapping the value.
|
|
* In contrast to the <code>Character</code> constructor, this method
|
|
* will cache some values. It is used by boxing conversion.
|
|
*
|
|
* @param val the value to wrap
|
|
* @return the <code>Character</code>
|
|
*
|
|
* @since 1.5
|
|
*/
|
|
public static Character valueOf(char val)
|
|
{
|
|
if (val > MAX_CACHE)
|
|
return new Character(val);
|
|
synchronized (charCache)
|
|
{
|
|
if (charCache[val - MIN_VALUE] == null)
|
|
charCache[val - MIN_VALUE] = new Character(val);
|
|
return charCache[val - MIN_VALUE];
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Reverse the bytes in val.
|
|
* @since 1.5
|
|
*/
|
|
public static char reverseBytes(char val)
|
|
{
|
|
return (char) (((val >> 8) & 0xff) | ((val << 8) & 0xff00));
|
|
}
|
|
|
|
/**
|
|
* Converts a unicode code point to a UTF-16 representation of that
|
|
* code point.
|
|
*
|
|
* @param codePoint the unicode code point
|
|
*
|
|
* @return the UTF-16 representation of that code point
|
|
*
|
|
* @throws IllegalArgumentException if the code point is not a valid
|
|
* unicode code point
|
|
*
|
|
* @since 1.5
|
|
*/
|
|
public static char[] toChars(int codePoint)
|
|
{
|
|
if (!isValidCodePoint(codePoint))
|
|
throw new IllegalArgumentException("Illegal Unicode code point : "
|
|
+ codePoint);
|
|
char[] result = new char[charCount(codePoint)];
|
|
int ignore = toChars(codePoint, result, 0);
|
|
return result;
|
|
}
|
|
|
|
/**
|
|
* Converts a unicode code point to its UTF-16 representation.
|
|
*
|
|
* @param codePoint the unicode code point
|
|
* @param dst the target char array
|
|
* @param dstIndex the start index for the target
|
|
*
|
|
* @return number of characters written to <code>dst</code>
|
|
*
|
|
* @throws IllegalArgumentException if <code>codePoint</code> is not a
|
|
* valid unicode code point
|
|
* @throws NullPointerException if <code>dst</code> is <code>null</code>
|
|
* @throws IndexOutOfBoundsException if <code>dstIndex</code> is not valid
|
|
* in <code>dst</code> or if the UTF-16 representation does not
|
|
* fit into <code>dst</code>
|
|
*
|
|
* @since 1.5
|
|
*/
|
|
public static int toChars(int codePoint, char[] dst, int dstIndex)
|
|
{
|
|
if (!isValidCodePoint(codePoint))
|
|
{
|
|
throw new IllegalArgumentException("not a valid code point: "
|
|
+ codePoint);
|
|
}
|
|
|
|
int result;
|
|
if (isSupplementaryCodePoint(codePoint))
|
|
{
|
|
// Write second char first to cause IndexOutOfBoundsException
|
|
// immediately.
|
|
final int cp2 = codePoint - 0x10000;
|
|
dst[dstIndex + 1] = (char) ((cp2 % 0x400) + (int) MIN_LOW_SURROGATE);
|
|
dst[dstIndex] = (char) ((cp2 / 0x400) + (int) MIN_HIGH_SURROGATE);
|
|
result = 2;
|
|
}
|
|
else
|
|
{
|
|
dst[dstIndex] = (char) codePoint;
|
|
result = 1;
|
|
}
|
|
return result;
|
|
}
|
|
|
|
/**
|
|
* Return number of 16-bit characters required to represent the given
|
|
* code point.
|
|
*
|
|
* @param codePoint a unicode code point
|
|
*
|
|
* @return 2 if codePoint >= 0x10000, 1 otherwise.
|
|
*
|
|
* @since 1.5
|
|
*/
|
|
public static int charCount(int codePoint)
|
|
{
|
|
return
|
|
(codePoint >= MIN_SUPPLEMENTARY_CODE_POINT)
|
|
? 2
|
|
: 1;
|
|
}
|
|
|
|
/**
|
|
* Determines whether the specified code point is
|
|
* in the range 0x10000 .. 0x10FFFF, i.e. the character is within the Unicode
|
|
* supplementary character range.
|
|
*
|
|
* @param codePoint a Unicode code point
|
|
*
|
|
* @return <code>true</code> if code point is in supplementary range
|
|
*
|
|
* @since 1.5
|
|
*/
|
|
public static boolean isSupplementaryCodePoint(int codePoint)
|
|
{
|
|
return codePoint >= MIN_SUPPLEMENTARY_CODE_POINT
|
|
&& codePoint <= MAX_CODE_POINT;
|
|
}
|
|
|
|
/**
|
|
* Determines whether the specified code point is
|
|
* in the range 0x0000 .. 0x10FFFF, i.e. it is a valid Unicode code point.
|
|
*
|
|
* @param codePoint a Unicode code point
|
|
*
|
|
* @return <code>true</code> if code point is valid
|
|
*
|
|
* @since 1.5
|
|
*/
|
|
public static boolean isValidCodePoint(int codePoint)
|
|
{
|
|
return codePoint >= MIN_CODE_POINT && codePoint <= MAX_CODE_POINT;
|
|
}
|
|
|
|
/**
|
|
* Return true if the given character is a high surrogate.
|
|
* @param ch the character
|
|
* @return true if the character is a high surrogate character
|
|
*
|
|
* @since 1.5
|
|
*/
|
|
public static boolean isHighSurrogate(char ch)
|
|
{
|
|
return ch >= MIN_HIGH_SURROGATE && ch <= MAX_HIGH_SURROGATE;
|
|
}
|
|
|
|
/**
|
|
* Return true if the given character is a low surrogate.
|
|
* @param ch the character
|
|
* @return true if the character is a low surrogate character
|
|
*
|
|
* @since 1.5
|
|
*/
|
|
public static boolean isLowSurrogate(char ch)
|
|
{
|
|
return ch >= MIN_LOW_SURROGATE && ch <= MAX_LOW_SURROGATE;
|
|
}
|
|
|
|
/**
|
|
* Return true if the given characters compose a surrogate pair.
|
|
* This is true if the first character is a high surrogate and the
|
|
* second character is a low surrogate.
|
|
* @param ch1 the first character
|
|
* @param ch2 the first character
|
|
* @return true if the characters compose a surrogate pair
|
|
*
|
|
* @since 1.5
|
|
*/
|
|
public static boolean isSurrogatePair(char ch1, char ch2)
|
|
{
|
|
return isHighSurrogate(ch1) && isLowSurrogate(ch2);
|
|
}
|
|
|
|
/**
|
|
* Given a valid surrogate pair, this returns the corresponding
|
|
* code point.
|
|
* @param high the high character of the pair
|
|
* @param low the low character of the pair
|
|
* @return the corresponding code point
|
|
*
|
|
* @since 1.5
|
|
*/
|
|
public static int toCodePoint(char high, char low)
|
|
{
|
|
return ((high - MIN_HIGH_SURROGATE) * 0x400) +
|
|
(low - MIN_LOW_SURROGATE) + 0x10000;
|
|
}
|
|
|
|
/**
|
|
* Get the code point at the specified index in the CharSequence.
|
|
* This is like CharSequence#charAt(int), but if the character is
|
|
* the start of a surrogate pair, and there is a following
|
|
* character, and this character completes the pair, then the
|
|
* corresponding supplementary code point is returned. Otherwise,
|
|
* the character at the index is returned.
|
|
*
|
|
* @param sequence the CharSequence
|
|
* @param index the index of the codepoint to get, starting at 0
|
|
* @return the codepoint at the specified index
|
|
* @throws IndexOutOfBoundsException if index is negative or >= length()
|
|
* @since 1.5
|
|
*/
|
|
public static int codePointAt(CharSequence sequence, int index)
|
|
{
|
|
int len = sequence.length();
|
|
if (index < 0 || index >= len)
|
|
throw new IndexOutOfBoundsException();
|
|
char high = sequence.charAt(index);
|
|
if (! isHighSurrogate(high) || ++index >= len)
|
|
return high;
|
|
char low = sequence.charAt(index);
|
|
if (! isLowSurrogate(low))
|
|
return high;
|
|
return toCodePoint(high, low);
|
|
}
|
|
|
|
/**
|
|
* Get the code point at the specified index in the CharSequence.
|
|
* If the character is the start of a surrogate pair, and there is a
|
|
* following character, and this character completes the pair, then
|
|
* the corresponding supplementary code point is returned.
|
|
* Otherwise, the character at the index is returned.
|
|
*
|
|
* @param chars the character array in which to look
|
|
* @param index the index of the codepoint to get, starting at 0
|
|
* @return the codepoint at the specified index
|
|
* @throws IndexOutOfBoundsException if index is negative or >= length()
|
|
* @since 1.5
|
|
*/
|
|
public static int codePointAt(char[] chars, int index)
|
|
{
|
|
return codePointAt(chars, index, chars.length);
|
|
}
|
|
|
|
/**
|
|
* Get the code point at the specified index in the CharSequence.
|
|
* If the character is the start of a surrogate pair, and there is a
|
|
* following character within the specified range, and this
|
|
* character completes the pair, then the corresponding
|
|
* supplementary code point is returned. Otherwise, the character
|
|
* at the index is returned.
|
|
*
|
|
* @param chars the character array in which to look
|
|
* @param index the index of the codepoint to get, starting at 0
|
|
* @param limit the limit past which characters should not be examined
|
|
* @return the codepoint at the specified index
|
|
* @throws IndexOutOfBoundsException if index is negative or >=
|
|
* limit, or if limit is negative or >= the length of the array
|
|
* @since 1.5
|
|
*/
|
|
public static int codePointAt(char[] chars, int index, int limit)
|
|
{
|
|
if (index < 0 || index >= limit || limit < 0 || limit > chars.length)
|
|
throw new IndexOutOfBoundsException();
|
|
char high = chars[index];
|
|
if (! isHighSurrogate(high) || ++index >= limit)
|
|
return high;
|
|
char low = chars[index];
|
|
if (! isLowSurrogate(low))
|
|
return high;
|
|
return toCodePoint(high, low);
|
|
}
|
|
|
|
/**
|
|
* Get the code point before the specified index. This is like
|
|
* #codePointAt(char[], int), but checks the characters at
|
|
* <code>index-1</code> and <code>index-2</code> to see if they form
|
|
* a supplementary code point. If they do not, the character at
|
|
* <code>index-1</code> is returned.
|
|
*
|
|
* @param chars the character array
|
|
* @param index the index just past the codepoint to get, starting at 0
|
|
* @return the codepoint at the specified index
|
|
* @throws IndexOutOfBoundsException if index is negative or >= length()
|
|
* @since 1.5
|
|
*/
|
|
public static int codePointBefore(char[] chars, int index)
|
|
{
|
|
return codePointBefore(chars, index, 1);
|
|
}
|
|
|
|
/**
|
|
* Get the code point before the specified index. This is like
|
|
* #codePointAt(char[], int), but checks the characters at
|
|
* <code>index-1</code> and <code>index-2</code> to see if they form
|
|
* a supplementary code point. If they do not, the character at
|
|
* <code>index-1</code> is returned. The start parameter is used to
|
|
* limit the range of the array which may be examined.
|
|
*
|
|
* @param chars the character array
|
|
* @param index the index just past the codepoint to get, starting at 0
|
|
* @param start the index before which characters should not be examined
|
|
* @return the codepoint at the specified index
|
|
* @throws IndexOutOfBoundsException if index is > start or >
|
|
* the length of the array, or if limit is negative or >= the
|
|
* length of the array
|
|
* @since 1.5
|
|
*/
|
|
public static int codePointBefore(char[] chars, int index, int start)
|
|
{
|
|
if (index < start || index > chars.length
|
|
|| start < 0 || start >= chars.length)
|
|
throw new IndexOutOfBoundsException();
|
|
--index;
|
|
char low = chars[index];
|
|
if (! isLowSurrogate(low) || --index < start)
|
|
return low;
|
|
char high = chars[index];
|
|
if (! isHighSurrogate(high))
|
|
return low;
|
|
return toCodePoint(high, low);
|
|
}
|
|
|
|
/**
|
|
* Get the code point before the specified index. This is like
|
|
* #codePointAt(CharSequence, int), but checks the characters at
|
|
* <code>index-1</code> and <code>index-2</code> to see if they form
|
|
* a supplementary code point. If they do not, the character at
|
|
* <code>index-1</code> is returned.
|
|
*
|
|
* @param sequence the CharSequence
|
|
* @param index the index just past the codepoint to get, starting at 0
|
|
* @return the codepoint at the specified index
|
|
* @throws IndexOutOfBoundsException if index is negative or >= length()
|
|
* @since 1.5
|
|
*/
|
|
public static int codePointBefore(CharSequence sequence, int index)
|
|
{
|
|
int len = sequence.length();
|
|
if (index < 1 || index > len)
|
|
throw new IndexOutOfBoundsException();
|
|
--index;
|
|
char low = sequence.charAt(index);
|
|
if (! isLowSurrogate(low) || --index < 0)
|
|
return low;
|
|
char high = sequence.charAt(index);
|
|
if (! isHighSurrogate(high))
|
|
return low;
|
|
return toCodePoint(high, low);
|
|
}
|
|
} // class Character
|