CharUtils (Cobble Lang 4.6.0 API)

java.lang.Object
- net.hasor.cobble.CharUtils

```
public class CharUtils
extends Object
```
Operations on char primitives and Character objects.

This class tries to handle null input gracefully. An exception will not be thrown for a null input. Each method documents its behaviour in more detail.

#ThreadSafe#

从以下版本开始:

2.1

版本:

$Id: CharUtils.java 1056988 2011-01-09 17:58:53Z niallp $

作者:

Apache Software Foundation

字段概要

字段
限定符和类型字段和说明

static char CR
carriage return CR ('\r').

static char LF
linefeed LF ('\n').

字段
限定符和类型	字段和说明
`static char`	`CR` carriage return CR ('\r').
`static char`	`LF` linefeed LF ('\n').

构造器概要

构造器
构造器和说明

CharUtils()
CharUtils instances should NOT be constructed in standard programming.

构造器
构造器和说明
`CharUtils()` `CharUtils` instances should NOT be constructed in standard programming.

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static boolean`	`isAscii(char ch)` Checks whether the character is ASCII 7 bit.
`static boolean`	`isAsciiAlpha(char ch)` Checks whether the character is ASCII 7 bit alphabetic.
`static boolean`	`isAsciiAlphaLower(char ch)` Checks whether the character is ASCII 7 bit alphabetic lower case.
`static boolean`	`isAsciiAlphanumeric(char ch)` Checks whether the character is ASCII 7 bit numeric.
`static boolean`	`isAsciiAlphaUpper(char ch)` Checks whether the character is ASCII 7 bit alphabetic upper case.
`static boolean`	`isAsciiControl(char ch)` Checks whether the character is ASCII 7 bit control.
`static boolean`	`isAsciiNumeric(char ch)` Checks whether the character is ASCII 7 bit numeric.
`static boolean`	`isAsciiPrintable(char ch)` Checks whether the character is ASCII 7 bit printable.
`static boolean`	`isCharType(Class targetType)`
`static char`	`toChar(Character ch)` Converts the Character to a char throwing an exception for `null`.
`static char`	`toChar(Character ch, char defaultValue)` Converts the Character to a char handling `null`.
`static char`	`toChar(String str)` Converts the String to a char using the first character, throwing an exception on empty Strings.
`static char`	`toChar(String str, char defaultValue)` Converts the String to a char using the first character, defaulting the value on empty Strings.
`static Character`	`toCharacterObject(char ch)` Converts the character to a Character.
`static Character`	`toCharacterObject(String str)` Converts the String to a Character using the first character, returning null for empty Strings.
`static int`	`toIntValue(char ch)` Converts the character to the Integer it represents, throwing an exception if the character is not numeric.
`static int`	`toIntValue(Character ch)` Converts the character to the Integer it represents, throwing an exception if the character is not numeric.
`static int`	`toIntValue(Character ch, int defaultValue)` Converts the character to the Integer it represents, throwing an exception if the character is not numeric.
`static int`	`toIntValue(char ch, int defaultValue)` Converts the character to the Integer it represents, throwing an exception if the character is not numeric.
`static String`	`toString(char ch)` Converts the character to a String that contains the one character.
`static String`	`toString(Character ch)` Converts the character to a String that contains the one character.
`static String`	`unicodeEscaped(char ch)` Converts the string to the unicode format ' '.
`static String`	`unicodeEscaped(Character ch)` Converts the string to the unicode format ' '.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - LF
```
public static final char LF
```
    linefeed LF ('\n').
    
    从以下版本开始:
    
    2.2
    
    另请参阅:
    
    JLF: Escape Sequences for Character and String Literals, 常量字段值
  - CR
```
public static final char CR
```
    carriage return CR ('\r').
    
    从以下版本开始:
    
    2.2
    
    另请参阅:
    
    JLF: Escape Sequences for Character and String Literals, 常量字段值
- 构造器详细资料
  - CharUtils
```
public CharUtils()
```
    CharUtils instances should NOT be constructed in standard programming. Instead, the class should be used as CharUtils.toString('c');.
    
    This constructor i public to permit tools that require a JavaBean instance to operate.
- 方法详细资料
  - toCharacterObject
```
public static Character toCharacterObject(char ch)
```
    Converts the character to a Character.
    
    For ASCII 7 bit characters, this uses a cache that will return the same Character object each time.
```
   CharUtils.toCharacterObject(' ')  = ' '
   CharUtils.toCharacterObject('A')  = 'A'
 
```
    参数:
    
    ch - the character to convert
    
    返回:
    
    a Character of the specified character
  - toCharacterObject
```
public static Character toCharacterObject(String str)
```
    Converts the String to a Character using the first character, returning null for empty Strings.
    
    For ASCII 7 bit characters, this uses a cache that will return the same Character object each time.
```
   CharUtils.toCharacterObject(null) = null
   CharUtils.toCharacterObject("")   = null
   CharUtils.toCharacterObject("A")  = 'A'
   CharUtils.toCharacterObject("BA") = 'B'
 
```
    参数:
    
    str - the character to convert
    
    返回:
    
    the Character value of the first letter of the String
  - toChar
```
public static char toChar(Character ch)
```
    Converts the Character to a char throwing an exception for null.
```
   CharUtils.toChar(null) = IllegalArgumentException
   CharUtils.toChar(' ')  = ' '
   CharUtils.toChar('A')  = 'A'
 
```
    参数:
    
    ch - the character to convert
    
    返回:
    
    the char value of the Character
    
    抛出:
    
    IllegalArgumentException - if the Character is null
  - toChar
```
public static char toChar(Character ch,
                          char defaultValue)
```
    Converts the Character to a char handling null.
```
   CharUtils.toChar(null, 'X') = 'X'
   CharUtils.toChar(' ', 'X')  = ' '
   CharUtils.toChar('A', 'X')  = 'A'
 
```
    参数:
    
    ch - the character to convert
    
    defaultValue - the value to use if the Character is null
    
    返回:
    
    the char value of the Character or the default if null
  - toChar
```
public static char toChar(String str)
```
    Converts the String to a char using the first character, throwing an exception on empty Strings.
```
   CharUtils.toChar(null) = IllegalArgumentException
   CharUtils.toChar("")   = IllegalArgumentException
   CharUtils.toChar("A")  = 'A'
   CharUtils.toChar("BA") = 'B'
 
```
    参数:
    
    str - the character to convert
    
    返回:
    
    the char value of the first letter of the String
    
    抛出:
    
    IllegalArgumentException - if the String is empty
  - toChar
```
public static char toChar(String str,
                          char defaultValue)
```
    Converts the String to a char using the first character, defaulting the value on empty Strings.
```
   CharUtils.toChar(null, 'X') = 'X'
   CharUtils.toChar("", 'X')   = 'X'
   CharUtils.toChar("A", 'X')  = 'A'
   CharUtils.toChar("BA", 'X') = 'B'
 
```
    参数:
    
    str - the character to convert
    
    defaultValue - the value to use if the Character is null
    
    返回:
    
    the char value of the first letter of the String or the default if null
  - toIntValue
```
public static int toIntValue(char ch)
```
    Converts the character to the Integer it represents, throwing an exception if the character is not numeric.
    
    This method coverts the char '1' to the int 1 and so on.
```
   CharUtils.toIntValue('3')  = 3
   CharUtils.toIntValue('A')  = IllegalArgumentException
 
```
    参数:
    
    ch - the character to convert
    
    返回:
    
    the int value of the character
    
    抛出:
    
    IllegalArgumentException - if the character is not ASCII numeric
  - toIntValue
```
public static int toIntValue(char ch,
                             int defaultValue)
```
    Converts the character to the Integer it represents, throwing an exception if the character is not numeric.
    
    This method coverts the char '1' to the int 1 and so on.
```
   CharUtils.toIntValue('3', -1)  = 3
   CharUtils.toIntValue('A', -1)  = -1
 
```
    参数:
    
    ch - the character to convert
    
    defaultValue - the default value to use if the character is not numeric
    
    返回:
    
    the int value of the character
  - toIntValue
```
public static int toIntValue(Character ch)
```
    Converts the character to the Integer it represents, throwing an exception if the character is not numeric.
    
    This method coverts the char '1' to the int 1 and so on.
```
   CharUtils.toIntValue(null) = IllegalArgumentException
   CharUtils.toIntValue('3')  = 3
   CharUtils.toIntValue('A')  = IllegalArgumentException
 
```
    参数:
    
    ch - the character to convert, not null
    
    返回:
    
    the int value of the character
    
    抛出:
    
    IllegalArgumentException - if the Character is not ASCII numeric or is null
  - toIntValue
```
public static int toIntValue(Character ch,
                             int defaultValue)
```
    Converts the character to the Integer it represents, throwing an exception if the character is not numeric.
    
    This method coverts the char '1' to the int 1 and so on.
```
   CharUtils.toIntValue(null, -1) = -1
   CharUtils.toIntValue('3', -1)  = 3
   CharUtils.toIntValue('A', -1)  = -1
 
```
    参数:
    
    ch - the character to convert
    
    defaultValue - the default value to use if the character is not numeric
    
    返回:
    
    the int value of the character
  - toString
```
public static String toString(char ch)
```
    Converts the character to a String that contains the one character.
    
    For ASCII 7 bit characters, this uses a cache that will return the same String object each time.
```
   CharUtils.toString(' ')  = " "
   CharUtils.toString('A')  = "A"
 
```
    参数:
    
    ch - the character to convert
    
    返回:
    
    a String containing the one specified character
  - toString
```
public static String toString(Character ch)
```
    Converts the character to a String that contains the one character.
    
    For ASCII 7 bit characters, this uses a cache that will return the same String object each time.
    
    If null is passed in, null will be returned.
```
   CharUtils.toString(null) = null
   CharUtils.toString(' ')  = " "
   CharUtils.toString('A')  = "A"
 
```
    参数:
    
    ch - the character to convert
    
    返回:
    
    a String containing the one specified character
  - unicodeEscaped
```
public static String unicodeEscaped(char ch)
```
    Converts the string to the unicode format ' '.
    
    This format is the Java source code format.
```
   CharUtils.unicodeEscaped(' ') = " "
   CharUtils.unicodeEscaped('A') = "A"
 
```
    参数:
    
    ch - the character to convert
    
    返回:
    
    the escaped unicode string
  - unicodeEscaped
```
public static String unicodeEscaped(Character ch)
```
    Converts the string to the unicode format ' '.
    
    This format is the Java source code format.
    
    If null is passed in, null will be returned.
```
   CharUtils.unicodeEscaped(null) = null
   CharUtils.unicodeEscaped(' ')  = " "
   CharUtils.unicodeEscaped('A')  = "A"
 
```
    参数:
    
    ch - the character to convert, may be null
    
    返回:
    
    the escaped unicode string, null if null input
  - isAscii
```
public static boolean isAscii(char ch)
```
    Checks whether the character is ASCII 7 bit.
```
   CharUtils.isAscii('a')  = true
   CharUtils.isAscii('A')  = true
   CharUtils.isAscii('3')  = true
   CharUtils.isAscii('-')  = true
   CharUtils.isAscii('\n') = true
   CharUtils.isAscii('©') = false
 
```
    参数:
    
    ch - the character to check
    
    返回:
    
    true if less than 128
  - isAsciiPrintable
```
public static boolean isAsciiPrintable(char ch)
```
    Checks whether the character is ASCII 7 bit printable.
```
   CharUtils.isAsciiPrintable('a')  = true
   CharUtils.isAsciiPrintable('A')  = true
   CharUtils.isAsciiPrintable('3')  = true
   CharUtils.isAsciiPrintable('-')  = true
   CharUtils.isAsciiPrintable('\n') = false
   CharUtils.isAsciiPrintable('©') = false
 
```
    参数:
    
    ch - the character to check
    
    返回:
    
    true if between 32 and 126 inclusive
  - isAsciiControl
```
public static boolean isAsciiControl(char ch)
```
    Checks whether the character is ASCII 7 bit control.
```
   CharUtils.isAsciiControl('a')  = false
   CharUtils.isAsciiControl('A')  = false
   CharUtils.isAsciiControl('3')  = false
   CharUtils.isAsciiControl('-')  = false
   CharUtils.isAsciiControl('\n') = true
   CharUtils.isAsciiControl('©') = false
 
```
    参数:
    
    ch - the character to check
    
    返回:
    
    true if less than 32 or equals 127
  - isAsciiAlpha
```
public static boolean isAsciiAlpha(char ch)
```
    Checks whether the character is ASCII 7 bit alphabetic.
```
   CharUtils.isAsciiAlpha('a')  = true
   CharUtils.isAsciiAlpha('A')  = true
   CharUtils.isAsciiAlpha('3')  = false
   CharUtils.isAsciiAlpha('-')  = false
   CharUtils.isAsciiAlpha('\n') = false
   CharUtils.isAsciiAlpha('©') = false
 
```
    参数:
    
    ch - the character to check
    
    返回:
    
    true if between 65 and 90 or 97 and 122 inclusive
  - isAsciiAlphaUpper
```
public static boolean isAsciiAlphaUpper(char ch)
```
    Checks whether the character is ASCII 7 bit alphabetic upper case.
```
   CharUtils.isAsciiAlphaUpper('a')  = false
   CharUtils.isAsciiAlphaUpper('A')  = true
   CharUtils.isAsciiAlphaUpper('3')  = false
   CharUtils.isAsciiAlphaUpper('-')  = false
   CharUtils.isAsciiAlphaUpper('\n') = false
   CharUtils.isAsciiAlphaUpper('©') = false
 
```
    参数:
    
    ch - the character to check
    
    返回:
    
    true if between 65 and 90 inclusive
  - isAsciiAlphaLower
```
public static boolean isAsciiAlphaLower(char ch)
```
    Checks whether the character is ASCII 7 bit alphabetic lower case.
```
   CharUtils.isAsciiAlphaLower('a')  = true
   CharUtils.isAsciiAlphaLower('A')  = false
   CharUtils.isAsciiAlphaLower('3')  = false
   CharUtils.isAsciiAlphaLower('-')  = false
   CharUtils.isAsciiAlphaLower('\n') = false
   CharUtils.isAsciiAlphaLower('©') = false
 
```
    参数:
    
    ch - the character to check
    
    返回:
    
    true if between 97 and 122 inclusive
  - isAsciiNumeric
```
public static boolean isAsciiNumeric(char ch)
```
    Checks whether the character is ASCII 7 bit numeric.
```
   CharUtils.isAsciiNumeric('a')  = false
   CharUtils.isAsciiNumeric('A')  = false
   CharUtils.isAsciiNumeric('3')  = true
   CharUtils.isAsciiNumeric('-')  = false
   CharUtils.isAsciiNumeric('\n') = false
   CharUtils.isAsciiNumeric('©') = false
 
```
    参数:
    
    ch - the character to check
    
    返回:
    
    true if between 48 and 57 inclusive
  - isAsciiAlphanumeric
```
public static boolean isAsciiAlphanumeric(char ch)
```
    Checks whether the character is ASCII 7 bit numeric.
```
   CharUtils.isAsciiAlphanumeric('a')  = true
   CharUtils.isAsciiAlphanumeric('A')  = true
   CharUtils.isAsciiAlphanumeric('3')  = true
   CharUtils.isAsciiAlphanumeric('-')  = false
   CharUtils.isAsciiAlphanumeric('\n') = false
   CharUtils.isAsciiAlphanumeric('©') = false
 
```
    参数:
    
    ch - the character to check
    
    返回:
    
    true if between 48 and 57 or 65 and 90 or 97 and 122 inclusive
  - isCharType
```
public static boolean isCharType(Class targetType)
```

类 CharUtils

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

LF

CR

构造器详细资料

CharUtils

方法详细资料

toCharacterObject

toCharacterObject

toChar

toChar

toChar

toChar

toIntValue

toIntValue

toIntValue

toIntValue

toString

toString

unicodeEscaped

unicodeEscaped

isAscii

isAsciiPrintable

isAsciiControl

isAsciiAlpha

isAsciiAlphaUpper

isAsciiAlphaLower

isAsciiNumeric

isAsciiAlphanumeric

isCharType