Working with File Paths

The Three-Step Writing Process

Writing to a file follows a strict sequence: open the file with an appropriate mode, write the data, and close the file. Opening creates a file handle, which is your program's connection to the file. Writing sends data through that handle, and closing finalizes the operation by flushing buffered data to physical storage.

1. Open the file with the mode that matches your task.
2. Call write() with the string you want to store.
3. Call close() when you finish writing.

What Write Mode Does

The open function takes a filename and a mode. The mode 'w' means write mode. When a file is opened in write mode, Python erases the file's existing contents before new data is written. If the file does not exist, opening it in write mode creates it. The returned file handle represents the connection through which your program communicates with the file.

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

Writing Through the File Handle

After the file is open, call write() on the file handle. The method accepts a string and returns an integer showing how many characters were written. For example, 'Hello, World!' contains 13 characters, so write() returns 13. The method does not automatically add a newline. If separate pieces of text should appear on separate lines, include the newline character explicitly in the string.

13

Why Closing Makes Data Persistent

Calling write() does not necessarily place the data on the physical storage device immediately. Python first stores the data in a temporary buffer in the program's memory. When close() executes, Python signals the operating system to flush that buffered data to physical storage. Closing also releases the file so other programs can access it. After the file is closed, its handle is no longer valid, so trying to write through that handle raises an error.

Write Mode or Append Mode

Choose the mode based on what should happen to existing contents. Write mode, 'w', erases the file first and then stores the new data. Append mode, 'a', preserves the existing contents and adds new data at the end. The distinction matters whenever a file already contains information.

file_handle = open('names.txt', 'w')
file_handle.write('Ada\n')
file_handle.close()

file_handle = open('names.txt', 'a')
file_handle.write('Grace\n')
file_handle.close()

In this example, the first opening uses 'w', so the file starts with the new text. The second opening uses 'a', so the existing text is preserved and the next name is added at the end. The explicit newline character keeps the names on separate lines.

Mistakes That Lose Data

• Opening an existing file with 'w' when the goal is to add one item.

  Write mode erases the file's existing contents before the new data is written.

  Fix: Use append mode, 'a', when existing contents must be preserved and the new data should go at the end.

• Assuming write() adds a newline automatically.

  write() stores the supplied string but does not add a newline by itself.

  Fix: Include the newline character explicitly, such as 'Ada\n', when the next data should begin on another line.

• 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 the final write.

• Trying to write after closing the file handle.

  The handle no longer represents an open connection to the file.

  Fix: Finish writing before close(), or open the file again when another writing operation is needed.

Practice Check

Essential Takeaways

1. Open a file before writing, use write() to insert a string, and close the file when finished.
2. Opening an existing file with 'w' erases its contents; opening it with 'a' preserves them and adds data at the end.
3. write() returns the number of characters written and does not add a newline automatically.
4. Data first enters a memory buffer, so close() is required to flush it to physical storage and release the file handle.