File Modes and Their Purposes

The Three-Step Contract

Writing to a file follows a strict sequence: open the file with a mode, write the data, and close the file. The mode states what you intend to do, the write operation places data into the file handle's buffer, and closing flushes that buffered data to physical storage. Each step has a different purpose, so skipping one breaks the process.

Opening with Write Mode

The open function takes a filename and a mode. The mode w means write mode. When a file already exists, opening it with w erases its entire existing contents before new data is written. This is intentional behavior, not an error. The file is then ready to receive new data through its file handle.

Writing Through the Buffer

After the file is open, write() inserts a string through the file handle. The data does not immediately appear on the physical storage device. Python first places it in a temporary buffer held in the program's memory. The buffer waits to be flushed to disk when the file is closed.

file_handle = open('output.txt', 'w') characters_written = file_handle.write('Hello, World!') file_handle.close()

The return value of write() is an integer: the number of characters written. For example, the string Hello, World! contains 13 characters, including the comma and space, so write() returns 13. write() does not automatically add a newline. If separate pieces of text should appear on separate lines, include the newline character explicitly.

Closing Makes Data Persistent

Closing is not merely cleanup. It transfers buffered data from the program's memory through the operating system to the physical storage device, and it releases the file so other programs can access it. Until close() executes, data remains in the buffer. A program crash, power failure, or unexpected shutdown before the buffer is flushed can cause that data to vanish.

Replacing or Preserving Content

Python provides two relevant modes for adding data. Write mode, w, erases existing contents and places new data into the resulting file. Append mode, a, preserves existing contents and adds new data at the end. The correct choice depends on whether the old contents are being replaced or extended.

Mistakes That Lose Data

• Opening an existing file with w when the intention is to add one item

  Write mode erases the entire existing file before new data is written.

  Fix: Use append mode a when new data should be added to the end.

• Expecting write() to add a newline automatically

  write() writes the supplied string exactly and does not add newlines.

  Fix: Include the newline character explicitly when separate lines are required.

• Leaving the file open after writing

  The data can remain in the program's memory buffer instead of being flushed to physical storage.

  Fix: Call close() immediately after finishing the writing operation.

• Trying to write after closing the handle

  The handle is no longer valid once it has been closed.

  Fix: Finish all writing before close(), or open a file connection again when appropriate.

Check Your Understanding

Essential Takeaways

1. Opening with w prepares a file for writing but erases its existing contents.
2. The write() method returns the number of characters written and does not add a newline automatically.
3. Written data first enters a memory buffer rather than immediately reaching physical storage.
4. Calling close() flushes the buffer to disk and releases the file handle.
5. Use a when existing contents must be preserved and new data should be added at the end.