Java 字符串转 long

引言

在 Java 编程中，经常会遇到将字符串转换为数字的需求。其中，字符串转换为 long 类型的数字是一种常见的需求。本文将详细介绍 Java 中字符串转 long 的方法和注意事项。

1. 字符串转 long 的方法

Java 提供了多种方法来实现字符串转 long 的功能。下面我们将逐一介绍这些方法的使用。

1.1 Long.parseLong()

Long.parseLong() 方法是将字符串转换为 long 类型的最基本和常用方法。它接受一个字符串参数，返回转换后的 long 值。

下面是使用 Long.parseLong() 方法的示例代码：

String str = "12345";
long num = Long.parseLong(str);
System.out.println("转换结果：" + num);

输出：

转换结果：12345

需要注意的是，如果字符串无法转换为有效的 long 数字，比如包含非数字字符或超出 long 类型的取值范围，将会抛出 NumberFormatException 异常。因此，在使用 Long.parseLong() 方法时，需要注意对异常的处理。

1.2 Long.valueOf()

Long.valueOf() 方法与 Long.parseLong() 方法类似，也可以将字符串转换为 long 类型。它的使用方式如下：

String str = "100";
long num = Long.valueOf(str);
System.out.println("转换结果：" + num);

输出：

转换结果：100

与 Long.parseLong() 方法不同的是，Long.valueOf() 方法返回的是一个 Long 对象，而不是基本数据类型 long。需要注意的是，使用 Long.valueOf() 方法可能会造成自动装箱的性能开销，因此在对性能要求较高的场景下，推荐使用 Long.parseLong() 方法。

1.3 自定义方法

除了使用 Long.parseLong() 和 Long.valueOf() 方法，我们还可以通过自定义方法来实现字符串转 long。这种方法常用于对字符串进行额外的处理，比如去除字符串中的特殊字符或进行格式化。

下面是一个示例代码，展示了一种自定义的字符串转 long 方法：

public static long convertToLong(String str) {
    // 假设字符串中只包含数字字符和可忽略的特殊字符
    StringBuilder sb = new StringBuilder();
    for (char c : str.toCharArray()) {
        if (Character.isDigit(c)) {
            sb.append(c);
        }
    }
    return Long.parseLong(sb.toString());
}

public static void main(String[] args) {
    String str = "12-34-56";
    long num = convertToLong(str);
    System.out.println("转换结果：" + num);
}

输出：

转换结果：123456

需要注意的是，使用自定义的字符串转 long 方法时，需要根据实际情况进行适当的修改和调整。

2. 注意事项

在进行字符串转 long 的过程中，有一些常见的注意事项需要了解和遵守。下面将介绍一些主要的注意事项。

2.1 字符串格式

在使用上述方法进行字符串转 long 之前，需要确保字符串的格式符合要求。一般来说，字符串应当只包含数字字符和可忽略的特殊字符。如果字符串格式不正确，可能会导致转换失败或得到错误的结果。

2.2 异常处理

在使用 Long.parseLong() 方法时，有可能会出现 NumberFormatException 异常，这是因为字符串无法转换为有效的 long 数字。在这种情况下，我们需要对异常进行适当的处理，比如给出错误提示或采取相应的措施。

下面是一个示例代码，展示了如何进行异常处理：

String str = "abc";
try {
    long num = Long.parseLong(str);
    System.out.println("转换结果：" + num);
} catch (NumberFormatException e) {
    System.out.println("字符串无法转换为有效的 long 数字");
}

输出：

字符串无法转换为有效的 long 数字

2.3 越界问题

在进行字符串转 long 时，需要注意结果的取值范围。long 类型的取值范围为 −9,223,372,036,854,775,808 到 9,223,372,036,854,775,807 （含两个端点）。如果转换结果超出这个范围，可能会导致数据溢出或得到错误的结果。

为避免该问题，可以事先判断字符串是否超过了 long 类型的边界。一种常用的方法是使用 Long.MIN_VALUE 和 Long.MAX_VALUE 常量进行比较，如下所示：

String str = "9223372036854775809";
long num;
if (str.length() < 19 || (str.length() == 19 && str.compareTo(Long.MAX_VALUE + "") <= 0)) {
    num = Long.parseLong(str);
    System.out.println("转换结果：" + num);
} else {
    System.out.println("转换失败：超出 long 类型的取值范围");
}

输出：

转换失败：超出 long 类型的取值范围

结论

本文详细介绍了 Java 中字符串转 long 的方法和注意事项。在实际开发中，我们可以根据需要选择合适的方法来实现字符串转 long 的功能。同时，也需要注意字符串的格式、异常处理和结果的取值范围等注意事项，以确保程序的正确性和健壮性。