1212 * Accepts decimal, hexadecimal, and octal numbers given by the
1213 * following grammar:
1214 *
1215 * <blockquote>
1216 * <dl>
1217 * <dt><i>DecodableString:</i>
1218 * <dd><i>Sign<sub>opt</sub> DecimalNumeral</i>
1219 * <dd><i>Sign<sub>opt</sub></i> {@code 0x} <i>HexDigits</i>
1220 * <dd><i>Sign<sub>opt</sub></i> {@code 0X} <i>HexDigits</i>
1221 * <dd><i>Sign<sub>opt</sub></i> {@code #} <i>HexDigits</i>
1222 * <dd><i>Sign<sub>opt</sub></i> {@code 0} <i>OctalDigits</i>
1223 *
1224 * <dt><i>Sign:</i>
1225 * <dd>{@code -}
1226 * <dd>{@code +}
1227 * </dl>
1228 * </blockquote>
1229 *
1230 * <i>DecimalNumeral</i>, <i>HexDigits</i>, and <i>OctalDigits</i>
1231 * are as defined in section 3.10.1 of
1232 * <cite>The Java™ Language Specification</cite>,
1233 * except that underscores are not accepted between digits.
1234 *
1235 * <p>The sequence of characters following an optional
1236 * sign and/or radix specifier ("{@code 0x}", "{@code 0X}",
1237 * "{@code #}", or leading zero) is parsed as by the {@code
1238 * Long.parseLong} method with the indicated radix (10, 16, or 8).
1239 * This sequence of characters must represent a positive value or
1240 * a {@link NumberFormatException} will be thrown. The result is
1241 * negated if first character of the specified {@code String} is
1242 * the minus sign. No whitespace characters are permitted in the
1243 * {@code String}.
1244 *
1245 * @param nm the {@code String} to decode.
1246 * @return a {@code Long} object holding the {@code long}
1247 * value represented by {@code nm}
1248 * @throws NumberFormatException if the {@code String} does not
1249 * contain a parsable {@code long}.
1250 * @see java.lang.Long#parseLong(String, int)
1251 * @since 1.2
1252 */
|
1212 * Accepts decimal, hexadecimal, and octal numbers given by the
1213 * following grammar:
1214 *
1215 * <blockquote>
1216 * <dl>
1217 * <dt><i>DecodableString:</i>
1218 * <dd><i>Sign<sub>opt</sub> DecimalNumeral</i>
1219 * <dd><i>Sign<sub>opt</sub></i> {@code 0x} <i>HexDigits</i>
1220 * <dd><i>Sign<sub>opt</sub></i> {@code 0X} <i>HexDigits</i>
1221 * <dd><i>Sign<sub>opt</sub></i> {@code #} <i>HexDigits</i>
1222 * <dd><i>Sign<sub>opt</sub></i> {@code 0} <i>OctalDigits</i>
1223 *
1224 * <dt><i>Sign:</i>
1225 * <dd>{@code -}
1226 * <dd>{@code +}
1227 * </dl>
1228 * </blockquote>
1229 *
1230 * <i>DecimalNumeral</i>, <i>HexDigits</i>, and <i>OctalDigits</i>
1231 * are as defined in section 3.10.1 of
1232 * <cite>The Java Language Specification</cite>,
1233 * except that underscores are not accepted between digits.
1234 *
1235 * <p>The sequence of characters following an optional
1236 * sign and/or radix specifier ("{@code 0x}", "{@code 0X}",
1237 * "{@code #}", or leading zero) is parsed as by the {@code
1238 * Long.parseLong} method with the indicated radix (10, 16, or 8).
1239 * This sequence of characters must represent a positive value or
1240 * a {@link NumberFormatException} will be thrown. The result is
1241 * negated if first character of the specified {@code String} is
1242 * the minus sign. No whitespace characters are permitted in the
1243 * {@code String}.
1244 *
1245 * @param nm the {@code String} to decode.
1246 * @return a {@code Long} object holding the {@code long}
1247 * value represented by {@code nm}
1248 * @throws NumberFormatException if the {@code String} does not
1249 * contain a parsable {@code long}.
1250 * @see java.lang.Long#parseLong(String, int)
1251 * @since 1.2
1252 */
|