SunSPOT API V3.0


java.lang
Class Character

java.lang.Object
  extended by java.lang.Character

public final class Character
extends Object

The Character class wraps a value of the primitive type char in an object. An object of type Character contains a single field whose type is char.

In addition, this class provides several methods for determining the type of a character and converting characters from uppercase to lowercase and vice versa.

Character information is based on the Unicode Standard, version 3.0. However, in order to reduce footprint, by default the character property and case conversion operations in CLDC are available only for the ISO Latin-1 range of characters. Other Unicode character blocks can be supported as necessary.

Since:
JDK1.0, CLDC 1.0
Version:
12/17/01 (CLDC 1.1)

Field Summary
static int MAX_RADIX
          The maximum radix available for conversion to and from Strings.
static char MAX_VALUE
          The constant value of this field is the largest value of type char.
static int MIN_RADIX
          The minimum radix available for conversion to and from Strings.
static char MIN_VALUE
          The constant value of this field is the smallest value of type char.
 
Constructor Summary
Character(char value)
          Constructs a Character object and initializes it so that it represents the primitive value argument.
 
Method Summary
 char charValue()
          Returns the value of this Character object.
static int digit(char ch, int radix)
          Returns the numeric value of the character ch in the specified radix.
 boolean equals(Object obj)
          Compares this object against the specified object.
 int hashCode()
          Returns a hash code for this Character.
static boolean isDigit(char ch)
          Determines if the specified character is a digit.
static boolean isLowerCase(char ch)
          Determines if the specified character is a lowercase character.
static boolean isUpperCase(char ch)
          Determines if the specified character is an uppercase character.
static char toLowerCase(char ch)
          The given character is mapped to its lowercase equivalent; if the character has no lowercase equivalent, the character itself is returned.
 String toString()
          Returns a String object representing this character's value.
static char toUpperCase(char ch)
          Converts the character argument to uppercase; if the character has no uppercase equivalent, the character itself is returned.
 
Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

MAX_RADIX

public static final int MAX_RADIX
The maximum radix available for conversion to and from Strings.

See Also:
Integer.toString(int, int), Integer.valueOf(java.lang.String), Constant Field Values

MAX_VALUE

public static final char MAX_VALUE
The constant value of this field is the largest value of type char.

Since:
JDK1.0.2
See Also:
Constant Field Values

MIN_RADIX

public static final int MIN_RADIX
The minimum radix available for conversion to and from Strings.

See Also:
Integer.toString(int, int), Integer.valueOf(java.lang.String), Constant Field Values

MIN_VALUE

public static final char MIN_VALUE
The constant value of this field is the smallest value of type char.

Since:
JDK1.0.2
See Also:
Constant Field Values
Constructor Detail

Character

public Character(char value)
Constructs a Character object and initializes it so that it represents the primitive value argument.

Parameters:
value - value for the new Character object.
Method Detail

charValue

public char charValue()
Returns the value of this Character object.

Returns:
the primitive char value represented by this object.

digit

public static int digit(char ch,
                        int radix)
Returns the numeric value of the character ch in the specified radix.

Parameters:
ch - the character to be converted.
radix - the radix.
Returns:
the numeric value represented by the character in the specified radix.
Since:
JDK1.0
See Also:
isDigit(char)

equals

public boolean equals(Object obj)
Compares this object against the specified object. The result is true if and only if the argument is not null and is a Character object that represents the same char value as this object.

Overrides:
equals in class Object
Parameters:
obj - the object to compare with.
Returns:
true if the objects are the same; false otherwise.
See Also:
Boolean.hashCode(), Hashtable

hashCode

public int hashCode()
Returns a hash code for this Character.

Overrides:
hashCode in class Object
Returns:
a hash code value for this object.
See Also:
Object.equals(java.lang.Object), Hashtable

isDigit

public static boolean isDigit(char ch)
Determines if the specified character is a digit.

Parameters:
ch - the character to be tested.
Returns:
true if the character is a digit; false otherwise.
Since:
JDK1.0

isLowerCase

public static boolean isLowerCase(char ch)
Determines if the specified character is a lowercase character.

Note that by default CLDC only supports the ISO Latin-1 range of characters.

Of the ISO Latin-1 characters (character codes 0x0000 through 0x00FF), the following are lowercase:

a b c d e f g h i j k l m n o p q r s t u v w x y z \u00DF \u00E0 \u00E1 \u00E2 \u00E3 \u00E4 \u00E5 \u00E6 \u00E7 \u00E8 \u00E9 \u00EA \u00EB \u00EC \u00ED \u00EE \u00EF \u00F0 \u00F1 \u00F2 \u00F3 \u00F4 \u00F5 \u00F6 \u00F8 \u00F9 \u00FA \u00FB \u00FC \u00FD \u00FE \u00FF

Parameters:
ch - the character to be tested.
Returns:
true if the character is lowercase; false otherwise.
Since:
JDK1.0

isUpperCase

public static boolean isUpperCase(char ch)
Determines if the specified character is an uppercase character.

Note that by default CLDC only supports the ISO Latin-1 range of characters.

Of the ISO Latin-1 characters (character codes 0x0000 through 0x00FF), the following are uppercase:

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z \u00C0 \u00C1 \u00C2 \u00C3 \u00C4 \u00C5 \u00C6 \u00C7 \u00C8 \u00C9 \u00CA \u00CB \u00CC \u00CD \u00CE \u00CF \u00D0 \u00D1 \u00D2 \u00D3 \u00D4 \u00D5 \u00D6 \u00D8 \u00D9 \u00DA \u00DB \u00DC \u00DD \u00DE

Parameters:
ch - the character to be tested.
Returns:
true if the character is uppercase; false otherwise.
Since:
1.0
See Also:
isLowerCase(char), toUpperCase(char)

toLowerCase

public static char toLowerCase(char ch)
The given character is mapped to its lowercase equivalent; if the character has no lowercase equivalent, the character itself is returned.

Note that by default CLDC only supports the ISO Latin-1 range of characters.

Parameters:
ch - the character to be converted.
Returns:
the lowercase equivalent of the character, if any; otherwise the character itself.
Since:
JDK1.0
See Also:
isLowerCase(char), isUpperCase(char), toUpperCase(char)

toString

public String toString()
Returns a String object representing this character's value. Converts this Character object to a string. The result is a string whose length is 1. The string's sole component is the primitive char value represented by this object.

Overrides:
toString in class Object
Returns:
a string representation of this object.

toUpperCase

public static char toUpperCase(char ch)
Converts the character argument to uppercase; if the character has no uppercase equivalent, the character itself is returned.

Note that by default CLDC only supports the ISO Latin-1 range of characters.

Parameters:
ch - the character to be converted.
Returns:
the uppercase equivalent of the character, if any; otherwise the character itself.
Since:
JDK1.0
See Also:
isLowerCase(char), isUpperCase(char), toLowerCase(char)

SunSPOT API V3.0


Copyright © 2006, 2007 Sun Microsystems, Inc. All Rights Reserved.