/**
* Parses the string argument as a signed integer in the radix
* specified by the second argument. The characters in the string
* must all be digits of the specified radix (as determined by
* whether {@link java.lang.Character#digit(char, int)} returns a
* nonnegative value), except that the first character may be an
* ASCII minus sign {@code '-'} ({@code '\u005Cu002D'}) to
* indicate a negative value or an ASCII plus sign {@code '+'}
* ({@code '\u005Cu002B'}) to indicate a positive value. The
* resulting integer value is returned.
* 根据第二个参数radix传入的进制数将该字符串转化为一个整数类型。字符串中的字符必须全部为
* 特定进制的数字(全数字表示返回一个非负数),除非第一个字符可能是ASCII的负号{@code '-'}
* ({@code '\u005Cu002D'})表示一个负数或者一个ASCII的正号{@code '+'}({@code
* '\u005Cu002B'})表示一个正数。整数结果以返回值的形式返回。
*
* <p>An exception of type {@code NumberFormatException} is
* thrown if any of the following situations occurs:
* 如果一下任何一个情况发生会抛出一个类型为{@code NumberFormatException}(数字格式)
* 的异常。
*
* <ul>
* <li>The first argument is {@code null} or is a string of
* length zero.
* 情况一:第一个参数为空或者是一个长度为0的字符串。
*
* <li>The radix is either smaller than
* {@link java.lang.Character#MIN_RADIX} or
* larger than {@link java.lang.Character#MAX_RADIX}.
* 情况二:参数radix小于{@link java.lang.Character#MIN_RADIX}或者
* 大于{@link java.lang.Character#MAX_RADIX}
*
* <li>Any character of the string is not a digit of the specified
* radix, except that the first character may be a minus sign
* {@code '-'} ({@code '\u005Cu002D'}) or plus sign
* {@code '+'} ({@code '\u005Cu002B'}) provided that the
* string is longer than length 1.
* 情况三:任意一个字符不是特定进制的数字,除了长度大于1的字符串的第一个字符
* 可能为负号或者正号。
*
* <li>The value represented by the string is not a value of type
* {@code int}.
* </ul>
* 该字符串代表的值不是一个{@code int}(整数)类型的值。
*
* <p>Examples:
* <blockquote><pre>
* parseInt("0", 10) returns 0
* parseInt("473", 10) returns 473
* parseInt("+42", 10) returns 42
* parseInt("-0", 10) returns 0
* parseInt("-FF", 16) returns -255
* parseInt("1100110", 2) returns 102
* parseInt("2147483647", 10) returns 2147483647
* parseInt("-2147483648", 10) returns -2147483648
* parseInt("2147483648", 10) throws a NumberFormatException
* parseInt("99", 8) throws a NumberFormatException
* parseInt("Kona", 10) throws a NumberFormatException
* parseInt("Kona", 27) returns 411787
* </pre></blockquote>
*
* @param s the {@code String} containing the integer
* representation to be parsed
* @param radix the radix to be used while parsing {@code s}.
* @return the integer represented by the string argument in the
* specified radix.
* @exception NumberFormatException if the {@code String}
* does not contain a parsable {@code int}.
*/
public static int parseInt(String s, int radix)
throws NumberFormatException
{
/*
* WARNING: This method may be invoked early during VM initialization
* before IntegerCache is initialized. Care must be taken to not use
* the valueOf method.
*/
if (s == null) {//判断该字符串是否为空
throw new NumberFormatException("null");
}
if (radix < Character.MIN_RADIX) {//判断进制数是否小于最小进制数
throw new NumberFormatException("radix " + radix +
" less than Character.MIN_RADIX");
}
if (radix > Character.MAX_RADIX) {//判断进制数是否大于最大进制数
throw new NumberFormatException("radix " + radix +
" greater than Character.MAX_RADIX");
}
int result = 0;//定义整数结果
boolean negative = false;//定义是否为负数的flag,true表示为负数
int i = 0, len = s.length();//定义计数器以及计数器的上限
int limit = -Integer.MAX_VALUE;//获取Integer类型的最大值,将其反转为负数
int multmin;//设定转换后的整数的最大值,因为以负数计算的所以是min
int digit;//定义为字符串中每一位字符的存储变量
if (len > 0) {//判断字符串长度是否大于0
char firstChar = s.charAt(0);//获取字符串的第一个字符
if (firstChar < '0') { //判断第一个字符是否是正负号(通过Unicode码)
if (firstChar == '-') {//第一个字符是负号的情况
negative = true;//设置为负数
limit = Integer.MIN_VALUE;
} else if (firstChar != '+')
//如果第一个字符既不是数字也不是正负号则抛异常
throw NumberFormatException.forInputString(s);
if (len == 1)
//如果长度为1且第一个字符为正负号则抛异常
throw NumberFormatException.forInputString(s);
i++;//第一个字符为正负号,所以计数器从第二个字符开始算数字
}
//计算特定进制的数字的最大值
multmin = limit / radix;
while (i < len) {//计数器不到上限持续循环
//每个i位置的字符都转换为对应radix的进制的数字
digit = Character.digit(s.charAt(i++),radix);
if (digit < 0) {
//如果转换过来的数字小于0则抛出异常
throw NumberFormatException.forInputString(s);
}
if (result < multmin) {
//判断结果是否超过了最大范围,因为是以负数去计算的,所以反转过来判断小于最小值
throw NumberFormatException.forInputString(s);
}
//每循环一次就乘以一次进制数,表示位数高一位,例如十位变成百位
result *= radix;
if (result < limit + digit) {
//判断结果是否超过了最大范围,因为是以负数去计算的,所以反转过来判断小于最小值
throw NumberFormatException.forInputString(s);
}
//之前已经乘以了进制数,所以每一次循环到这个位都是0,加上当前的那一位即可,因为是以负数计算的,所以是减digit
result -= digit;
}
} else {
throw NumberFormatException.forInputString(s);
}
//通过正负数的flag来判断是否正负反转结果整数
return negative ? result : -result;
}