Struct JavaCharacter 

pub struct JavaCharacter<'mc>(/* private fields */);

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

In addition, this class provides a large number of static methods for determining a character's category (lowercase letter, digit, etc.) and for converting characters from uppercase to lowercase and vice versa.

Unicode Conformance

The fields and methods of class Character are defined in terms of character information from the Unicode Standard, specifically the UnicodeData file that is part of the Unicode Character Database. This file specifies properties including name and category for every assigned Unicode code point or character range. The file is available from the Unicode Consortium at http://www.unicode.org.

The Java SE 8 Platform uses character information from version 6.2 of the Unicode Standard, with three extensions. First, in recognition of the fact that new currencies appear frequently, the Java SE 8 Platform allows an implementation of class Character to use the Currency Symbols block from version 10.0 of the Unicode Standard. Second, the Java SE 8 Platform allows an implementation of class Character to use the code points in the range of U+9FCD to U+9FEF from version 11.0 of the Unicode Standard and in the CJK Unified Ideographs Extension E block from version 8.0 of the Unicode Standard, in order for the class to allow the "Implementation Level 2" of the Chinese GB18030-2022 standard. Third, the Java SE 8 Platform allows an implementation of class Character to use the Japanese Era code point, U+32FF, from the Unicode Standard version 12.1. Consequently, the behavior of fields and methods of class Character may vary across implementations of the Java SE 8 Platform when processing the aforementioned code points ( outside of version 6.2 ), except for the following methods that define Java identifiers: isJavaIdentifierStart(int), isJavaIdentifierStart(char), isJavaIdentifierPart(int), and isJavaIdentifierPart(char). Code points in Java identifiers must be drawn from version 6.2 of the Unicode Standard.

Unicode Character Representations

The char data type (and therefore the value that a Character object encapsulates) are based on the original Unicode specification, which defined characters as fixed-width 16-bit entities. The Unicode Standard has since been changed to allow for characters whose representation requires more than 16 bits.The range of legal code points is now U+0000 to U+10FFFF, known as Unicode scalar value. (Refer to the definition of the U+n notation in the Unicode Standard.)

The set of characters from U+0000 to U+FFFF is sometimes referred to as the Basic Multilingual Plane (BMP). Characters whose code points are greater than U+FFFF are called supplementary characters.The Java platform uses the UTF-16 representation in char arrays and in the String and StringBuffer classes. In this representation, supplementary characters are represented as a pair of char values, the first from the high-surrogates range, (\uD800-\uDBFF), the second from the low-surrogates range (\uDC00-\uDFFF).

A char value, therefore, represents Basic Multilingual Plane (BMP) code points, including the surrogate code points, or code units of the UTF-16 encoding. An int value represents all Unicode code points, including supplementary code points. The lower (least significant) 21 bits of int are used to represent Unicode code points and the upper (most significant) 11 bits must be zero. Unless otherwise specified, the behavior with respect to supplementary characters and surrogate char values is as follows:

• The methods that only accept a char value cannot support supplementary characters. They treat char values from the surrogate ranges as undefined characters. For example, Character.isLetter('\uD840') returns false, even though this specific value if followed by any low-surrogate value in a string would represent a letter.
• The methods that accept an int value support all Unicode characters, including supplementary characters. For example, Character.isLetter(0x2F81A) returns true because the code point value represents a letter (a CJK ideograph).

In the Java SE API documentation, Unicode code point is used for character values in the range between U+0000 and U+10FFFF, and Unicode code unit is used for 16-bit char values that are code units of the UTF-16 encoding. For more information on Unicode terminology, refer to the Unicode Glossary.

Implementations

impl<'mc> JavaCharacter<'mc>

pub fn new( jni: &SharedJNIEnv<'mc>, arg0: u16, ) -> Result<JavaCharacter<'mc>, Box<dyn Error>>

👎Deprecated

pub fn get_name( jni: &SharedJNIEnv<'mc>, arg0: i32, ) -> Result<String, Box<dyn Error>>

pub fn is_java_identifier_start_with_int( jni: &SharedJNIEnv<'mc>, arg0: i32, ) -> Result<bool, Box<dyn Error>>

pub fn is_java_identifier_part_with_int( jni: &SharedJNIEnv<'mc>, arg0: i32, ) -> Result<bool, Box<dyn Error>>

pub fn equals(&self, arg0: JObject<'mc>) -> Result<bool, Box<dyn Error>>

pub fn to_string_with_char( jni: &SharedJNIEnv<'mc>, arg0: Option<u16>, ) -> Result<String, Box<dyn Error>>

pub fn hash_code_with_char( jni: &SharedJNIEnv<'mc>, arg0: Option<u16>, ) -> Result<i32, Box<dyn Error>>

pub fn reverse_bytes( jni: &SharedJNIEnv<'mc>, arg0: u16, ) -> Result<u16, Box<dyn Error>>

pub fn compare_to_with_character( &self, arg0: u16, ) -> Result<i32, Box<dyn Error>>

pub fn is_digit_with_char( jni: &SharedJNIEnv<'mc>, arg0: u16, ) -> Result<bool, Box<dyn Error>>

pub fn is_lower_case_with_char( jni: &SharedJNIEnv<'mc>, arg0: u16, ) -> Result<bool, Box<dyn Error>>

pub fn is_upper_case_with_int( jni: &SharedJNIEnv<'mc>, arg0: i32, ) -> Result<bool, Box<dyn Error>>

pub fn is_whitespace_with_char( jni: &SharedJNIEnv<'mc>, arg0: u16, ) -> Result<bool, Box<dyn Error>>

pub fn compare( jni: &SharedJNIEnv<'mc>, arg0: u16, arg1: u16, ) -> Result<i32, Box<dyn Error>>

pub fn char_value(&self) -> Result<u16, Box<dyn Error>>

pub fn to_chars_with_int( jni: &SharedJNIEnv<'mc>, arg0: i32, arg1: Option<Vec<u16>>, arg2: Option<i32>, ) -> Result<i32, Box<dyn Error>>

pub fn is_high_surrogate( jni: &SharedJNIEnv<'mc>, arg0: u16, ) -> Result<bool, Box<dyn Error>>

pub fn is_low_surrogate( jni: &SharedJNIEnv<'mc>, arg0: u16, ) -> Result<bool, Box<dyn Error>>

pub fn is_surrogate( jni: &SharedJNIEnv<'mc>, arg0: u16, ) -> Result<bool, Box<dyn Error>>

pub fn is_supplementary_code_point( jni: &SharedJNIEnv<'mc>, arg0: i32, ) -> Result<bool, Box<dyn Error>>

pub fn high_surrogate( jni: &SharedJNIEnv<'mc>, arg0: i32, ) -> Result<u16, Box<dyn Error>>

pub fn low_surrogate( jni: &SharedJNIEnv<'mc>, arg0: i32, ) -> Result<u16, Box<dyn Error>>

pub fn to_code_point( jni: &SharedJNIEnv<'mc>, arg0: u16, arg1: u16, ) -> Result<i32, Box<dyn Error>>

pub fn code_point_at_with_chars( jni: &SharedJNIEnv<'mc>, arg0: Vec<u16>, arg1: i32, arg2: Option<i32>, ) -> Result<i32, Box<dyn Error>>

pub fn code_point_before_with_chars( jni: &SharedJNIEnv<'mc>, arg0: Vec<u16>, arg1: i32, arg2: Option<i32>, ) -> Result<i32, Box<dyn Error>>

pub fn offset_by_code_points_with_chars( jni: &SharedJNIEnv<'mc>, arg0: Vec<u16>, arg1: i32, arg2: i32, arg3: Option<i32>, arg4: Option<i32>, ) -> Result<i32, Box<dyn Error>>

pub fn to_lower_case_with_char( jni: &SharedJNIEnv<'mc>, arg0: u16, ) -> Result<u16, Box<dyn Error>>

pub fn to_upper_case_with_int( jni: &SharedJNIEnv<'mc>, arg0: i32, ) -> Result<i32, Box<dyn Error>>

pub fn is_bmp_code_point( jni: &SharedJNIEnv<'mc>, arg0: i32, ) -> Result<bool, Box<dyn Error>>

pub fn describe_constable(&self) -> Result<JavaOptional<'mc>, Box<dyn Error>>

pub fn get_type_with_int( jni: &SharedJNIEnv<'mc>, arg0: i32, ) -> Result<i32, Box<dyn Error>>

pub fn is_letter_with_int( jni: &SharedJNIEnv<'mc>, arg0: i32, ) -> Result<bool, Box<dyn Error>>

pub fn is_letter_or_digit_with_char( jni: &SharedJNIEnv<'mc>, arg0: u16, ) -> Result<bool, Box<dyn Error>>

pub fn is_valid_code_point( jni: &SharedJNIEnv<'mc>, arg0: i32, ) -> Result<bool, Box<dyn Error>>

pub fn is_title_case_with_char( jni: &SharedJNIEnv<'mc>, arg0: u16, ) -> Result<bool, Box<dyn Error>>

pub fn is_defined_with_char( jni: &SharedJNIEnv<'mc>, arg0: u16, ) -> Result<bool, Box<dyn Error>>

pub fn is_ideographic( jni: &SharedJNIEnv<'mc>, arg0: i32, ) -> Result<bool, Box<dyn Error>>

pub fn is_unicode_identifier_start_with_char( jni: &SharedJNIEnv<'mc>, arg0: u16, ) -> Result<bool, Box<dyn Error>>

pub fn is_unicode_identifier_part_with_char( jni: &SharedJNIEnv<'mc>, arg0: u16, ) -> Result<bool, Box<dyn Error>>

pub fn is_identifier_ignorable_with_char( jni: &SharedJNIEnv<'mc>, arg0: u16, ) -> Result<bool, Box<dyn Error>>

pub fn to_title_case_with_char( jni: &SharedJNIEnv<'mc>, arg0: u16, ) -> Result<u16, Box<dyn Error>>

pub fn digit_with_char( jni: &SharedJNIEnv<'mc>, arg0: u16, arg1: i32, ) -> Result<i32, Box<dyn Error>>

pub fn get_numeric_value_with_char( jni: &SharedJNIEnv<'mc>, arg0: u16, ) -> Result<i32, Box<dyn Error>>

pub fn is_space_char_with_char( jni: &SharedJNIEnv<'mc>, arg0: u16, ) -> Result<bool, Box<dyn Error>>

pub fn is_isocontrol_with_int( jni: &SharedJNIEnv<'mc>, arg0: i32, ) -> Result<bool, Box<dyn Error>>

pub fn get_directionality_with_char( jni: &SharedJNIEnv<'mc>, arg0: u16, ) -> Result<i8, Box<dyn Error>>

pub fn is_mirrored_with_int( jni: &SharedJNIEnv<'mc>, arg0: i32, ) -> Result<bool, Box<dyn Error>>

pub fn is_surrogate_pair( jni: &SharedJNIEnv<'mc>, arg0: u16, arg1: u16, ) -> Result<bool, Box<dyn Error>>

pub fn char_count( jni: &SharedJNIEnv<'mc>, arg0: i32, ) -> Result<i32, Box<dyn Error>>

pub fn is_java_letter( jni: &SharedJNIEnv<'mc>, arg0: u16, ) -> Result<bool, Box<dyn Error>>

pub fn is_java_letter_or_digit( jni: &SharedJNIEnv<'mc>, arg0: u16, ) -> Result<bool, Box<dyn Error>>

pub fn is_alphabetic( jni: &SharedJNIEnv<'mc>, arg0: i32, ) -> Result<bool, Box<dyn Error>>

pub fn is_space( jni: &SharedJNIEnv<'mc>, arg0: u16, ) -> Result<bool, Box<dyn Error>>

pub fn for_digit( jni: &SharedJNIEnv<'mc>, arg0: i32, arg1: i32, ) -> Result<u16, Box<dyn Error>>

pub fn code_point_of( jni: &SharedJNIEnv<'mc>, arg0: impl Into<String>, ) -> Result<i32, Box<dyn Error>>

pub fn instance_of(&self, other: impl Into<String>) -> Result<bool, Error>

Trait Implementations

impl<'mc> JNIInstantiatable<'mc> for JavaCharacter<'mc>

fn from_raw( env: &SharedJNIEnv<'mc>, obj: JObject<'mc>, ) -> Result<Self, Box<dyn Error>>

impl<'mc> JNIRaw<'mc> for JavaCharacter<'mc>

fn jni_ref(&self) -> SharedJNIEnv<'mc>

fn jni_object(&self) -> JObject<'mc>