Java String Class lines() 方法与示例

Java中的String类提供了许多有用的方法来处理字符串。其中，lines()方法是一个非常有用的方法，可以将一个字符串按照行进行分割，并返回一个流（Stream）对象。

方法签名

public Stream<String> lines()

方法描述

该方法返回一个包含字符串中所有行的Stream对象。行的定义是按照 \n、\r、或 \r\n 进行分割的。分割符不包含在任何行中。

示例

下面是一个示例，展示了如何使用lines()方法将一个字符串按照行进行分割：

String str = "Hello\nWorld\nJava";
Stream<String> lines = str.lines();
lines.forEach(System.out::println);

上述代码将输出以下结果：

Hello
World
Java

可以看到，lines()方法已经成功将字符串按照行进行了分割，并返回了一个包含所有行的Stream对象。最后，我们使用forEach()方法遍历该流，并将每行打印到控制台上。

注意事项

• 如果字符串中不包含任何行分割符，则返回一个包含该字符串本身的单行流。
• 该方法在Java 11中添加，如果你的项目使用的是Java 10或更早版本，将无法使用该方法。
• 该方法返回的Stream对象是惰性求值的，也就是说它并不会立即进行分割，只有在对流进行遍历操作时才会执行分割操作。

异常

• NullPointerException - 如果当前字符串为null。

总结

lines()方法是Java String类中一个非常有用的方法，它可以帮助我们轻松地将一个字符串按照行进行分割。使用该方法时需要注意它在Java 11中添加，也需要注意使用的字符串是否包含行分割符，并且需要保证流被遍历时才会执行分割操作。