NewLine: примеры (JAVA)

Короткие примеры

1) BufferedWriter.newLine() с StringWriter для демонстрации содержимого:

import java.io.*;

StringWriter sw = new StringWriter();
BufferedWriter bw = new BufferedWriter(sw);
bw.write("line1");
bw.newLine();
bw.write("line2");
bw.flush();
System.out.println(sw.toString());

Результат (на Unix):
line1
line2

Результат (на Windows):
line1
line2

2) System.lineSeparator() возвращает строку разделителя:

String sep = System.lineSeparator();
String s = "a" + sep + "b";
System.out.println(s);

Результат (на Unix):
a
b

3) Использование форматного спецификатора %n:

String out = String.format("row1%nrow2");
System.out.print(out);

Результат: (платформенный разделитель)
row1
row2

4) PrintWriter.println для разных типов:

PrintWriter pw = new PrintWriter(System.out);
pw.println(123);
pw.println("text");
pw.flush();

Результат:
123
text

Похожие механизмы в Java

Краткий перечень похожих средств и их особенности:

• PrintWriter.println() - удобен для печати значений с автоматическим добавлением разделителя, не бросает checked-исключений при записи.
• Writer.write("\n") - прямая запись конкретного символа. Полезна при явной потребности в LF независимо от платформы.
• String.format("%n") - предпочтителен для форматированной строки, вставляет платформенный разделитель.
• System.getProperty("line.separator") - старый способ получения разделителя; сегодня удобнее использовать System.lineSeparator().

Когда выбирать: для потоковой записи в тексты лучше BufferedWriter.newLine(), для форматирования строк - %n или System.lineSeparator(), для явного кроссплатформенного LF - писать "\n". В сетевых протоколах и стандартах данных следует использовать точно определенную последовательность, например "\r\n" для протокола HTTP.

Аналоги в других языках

Краткие эквиваленты с примерами и отличиями:

• PHP: константа PHP_EOL или '\n'. Пример:

  echo "a" . PHP_EOL . "b";

  Результат на Unix:
  a
  b
  

• JavaScript: в браузере '\n'; в Node.js можно использовать require('os').EOL для платформенного разделителя.

  const os = require('os');
  console.log(['a','b'].join(os.EOL));

  Результат (Node.js на Unix):
  a
  b
  

• Python: os.linesep возвращает платформенный разделитель, но встроенная функция print() добавляет '\n' по умолчанию.

  import os
  print('a')
  print('b')
  

  Результат:
  a
  b
  

• SQL: специфично для СУБД. В SQL Server можно собрать CHAR(13)+CHAR(10) для CRLF, в PostgreSQL можно использовать литерал E'\n'.

  -- SQL Server
  SELECT 'a' + CHAR(13) + CHAR(10) + 'b';
  

  Результат: строка с CRLF между частями

• C#: Environment.NewLine, а также методы StreamWriter.WriteLine() и Console.WriteLine().

  Console.WriteLine("a");
  Console.WriteLine("b");
  

  Результат:
  a
  b
  

• Lua: простая строка '\n' и функции вывода, например print добавляет перевод строки.

  print('a')
  print('b')
  

  Результат:
  a
  b
  

• Go: константа отсутствует, но обычно используется "\n"; функция fmt.Println() добавляет перевод строки.

  fmt.Println("a")
  fmt.Println("b")
  

  Результат:
  a
  b
  

• Kotlin: использует те же средства JVM: System.lineSeparator(), println и т. д.

Отличия от Java: в некоторых языках системная константа отсутствует и принято всегда использовать '\n' или встроенные функции вывода, в других есть обертки для платформенной последовательности. При переносе кода следует учитывать требования формата данных и целевую платформу.

Типичные ошибки

• Ожидание конкретного разделителя: использование System.lineSeparator() внутри сетевого протокола, где требуется строго '\n' или '\r\n', приводит к несовместимости.

  // Неправильно для HTTP-заголовков
  String header = "Header: value" + System.lineSeparator();
  // HTTP требует \r\n
  

  Возможный эффект: сервер или клиент отвергает ответ из-за неверного окончания строки

• Игнорирование закрытия/сброса буфера: вызов newLine() без flush/close может не записать данные в файл окончательно.

  BufferedWriter bw = new BufferedWriter(new FileWriter("out.txt"));
  bw.write("a");
  bw.newLine();
  // забыли close/flush
  

  Результат: файл может остаться пустым или неполным

• Смешивание разных окончаний строк: при объединении текстов, записанных разными методами, может получиться смесь '\n' и '\r\n', что усложнит обработку.
• Использование PrintWriter без проверки ошибок: PrintWriter подавляет checked-исключения; ошибки записи нужно проверять методом checkError().

Изменения в библиотеках

Основные моменты по истории и изменениям:

• BufferedWriter.newLine() присутствует в Java с ранних версий и не претерпел значительных изменений.
• System.lineSeparator() появился в Java 7 как более удобная и явная замена обращения к System.getProperty("line.separator"). Рекомендуется использовать именно System.lineSeparator() в новых проектах.
• Форматный спецификатор %n используется в Formatter с самого появления API форматирования и остался стабильным.

Расширенные и редкие сценарии

1) Приведение всех окончаний строк в файле к LF или CRLF:

import java.nio.file.*;
import java.nio.charset.StandardCharsets;

Path p = Paths.get("input.txt");
String s = Files.readString(p, StandardCharsets.UTF_8);
// Нормализация к LF
s = s.replace("\r\n", "\n").replace('\r', '\n');
Files.writeString(Paths.get("normalized_unix.txt"), s, StandardCharsets.UTF_8);

Результат: файл normalized_unix.txt со всеми переводами строки в формате LF

2) Запись CSV с требованием CRLF (например, для совместимости с Excel на Windows):

try (BufferedWriter bw = Files.newBufferedWriter(Paths.get("data.csv"), StandardCharsets.UTF_8)) {
    bw.write("col1,col2");
    bw.write("\r\n"); // явно CRLF для CSV
    bw.write("a,баш");
    bw.write("\r\n");
}

Результат: CSV с CRLF в конце каждой строки, корректно открывается в Excel

3) Форматирование больших отчетов с Formatter и %n для производительности и читаемости:

StringBuilder sb = new StringBuilder();
Formatter fmt = new Formatter(sb);
fmt.format("Header:%n");
for (int i = 0; i < 3; i++) {
    fmt.format("line %d%n", i);
}
System.out.print(sb.toString());

Результат:
Header:
line 0
line 1
line 2

4) Создание текстового протокола, где требуется фиксированное окончание строки CRLF, пример простого HTTP-ответа:

String body = "Hello";
String response = "HTTP/1.1 200 OK\r\n"
    + "Content-Length: " + body.length() + "\r\n"
    + "Content-Type: text/plain\r\n"
    + "\r\n"
    + body;
// отправка response в сокет

Результат: корректный HTTP-ответ с CRLF как разделителем заголовков и тела

5) Создание тестов, сравнивающих строки без учета окончания линии (удобно при кросс-платформенных тестах):

String normalize(String s) {
    return s.replace("\r\n", "\n").replace('\r', '\n');
}
// использовать normalize для сравнения ожидаемой и фактической строки

Результат: сравнения не зависят от платформенного окончания строки

6) Использование StringWriter + BufferedWriter.newLine() для генерации текста в памяти с правильными разделителями:

StringWriter sw = new StringWriter();
try (BufferedWriter bw = new BufferedWriter(sw)) {
    bw.write("row1");
    bw.newLine();
    bw.write("row2");
}
System.out.println(sw.toString());

Результат: строка с платформенным разделителем между row1 и row2

Пояснение: практические задачи обычно сводятся к выбору между явным указанием символов окончания и использованием платформенных средств. В тестах и при генерации файлов для внешних систем - явное указание (например, "\r\n") снижает риск несовместимости.