# Appending to a File

How to add lines to the end of a file by opening a \`FileOutputStream\` in append mode.

Journeyman · Java · Updated November 16, 2026

By Gregor Dzierzon

If you need to append new information to a file you can create a file stream with the append setting set to true. To do this you have to create the `FileOutputStream` object manually, and then create the `PrintWriter`.

```java
var student = new Student("Zoe","Whitehouse",3.95);
var file = new File("student_grades.csv");

// the second argument specifies that you want to append
try(var stream = new FileOutputStream(file, true);
    var writer = new PrintWriter(stream))
{
    writer.printf("%s,%s,%.2f\n"
                  , student.getFirstName()
                  , student.getLastName()
                  , student.getGpa());
}
catch(IOException ex)
{
  System.out.println(ex.getMessage());
}
```

## Do it: replace or append

A new student joins the class, and the grade book writes their line to the class file. What's in the file afterwards depends on how the file was opened: `new PrintWriter(file)` replaces the file, and a `FileOutputStream` opened with `true` adds to its end.

The box has no files, so a file's lines are a `List<String>` here. Your method works out what the file holds after the new lines are written, either way.

The method gets three values:

- `fileLines`: the lines the file holds now. An empty list is a file that doesn't exist yet.
- `newLines`: the lines being written.
- `append`: `true` to add to the end of the file, `false` to replace it.

For example, the class file and one new student:

```java
List<String> fileLines = List.of("firstname,lastname,gpa", "Emily,Wilson,3.91");
List<String> newLines = List.of("Zoe,Whitehouse,3.95");
```

| `append` | The file afterwards |
|---|---|
| `true` | `firstname,lastname,gpa`, `Emily,Wilson,3.91`, `Zoe,Whitehouse,3.95` |
| `false` | `Zoe,Whitehouse,3.95` |

So `afterWriting(fileLines, newLines, true)` returns a list of those three lines, in that order.

**Your job:** write the method `afterWriting(List<String> fileLines, List<String> newLines, boolean append)` so it returns a new `List<String>`: the file's lines after writing.

- When `append` is `true`: the lines already there, in order, then the new lines.
- When `append` is `false`: only the new lines. Whatever was there is gone.
- Build a new list; don't change `fileLines` or `newLines`.
- Appending to a file that doesn't exist yet (an empty `fileLines`) gives only the new lines, as Java creates the file.

Practiced live on the lesson page: write the Java right there and check it.

## Cheat sheets

- [Writing to a File](https://www.ask-codey.com/cheat-sheets/working-with-the-filestream-filestream-defaults-cheat-sheet)

Source: https://www.ask-codey.com/lessons/working-with-the-filestream-appending-to-a-file
