Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

System.lineSeparator() — systemowy separator wierszy

System.lineSeparator() zwraca separator wierszy właściwy dla systemu. Używaj go przy budowaniu tekstu z natywnymi zakończeniami wierszy, ale nie zamiast separatora wymaganego przez format danych.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

public static String lineSeparator()
System.lineSeparator()

System.lineSeparator() to statyczna metoda bez argumentów, zwracająca String. Domyślny separator to "\n" (LF) w systemach UNIX i "\r\n" (CRLF) w Microsoft Windows. W OpenJDK 21 można ustawić inną początkową wartość właściwości line.separator za pomocą opcji startowej JVM.

Wynik jest zawsze taki sam: odpowiada początkowej wartości właściwości systemowej line.separator. Późniejsza zmiana tej właściwości nie zmienia wyniku metody; nie jest to bieżący odczyt przez System.getProperty("line.separator").

Używaj jej do składania tekstu wymagającego natywnych zakończeń wierszy. Jeżeli format wymaga konkretnie LF lub CRLF, wpisz wymagany separator zamiast wybierać go według systemu.

Przykład łączy dwa fragmenty tekstu separatorem i wypisuje wynik porównania. Dzięki temu oczekiwane wyjście true nie zależy od systemu, choć sam separator zależy.

Przykłady

public class Main {
    public static void main(String[] args) {
        String separator = System.lineSeparator();
        String text = "first" + separator + "second";
        System.out.print(text.equals("first" + separator + "second"));
    }
}

Wynik

true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła