Opens a file and returns it as a file object
Usage
The open() function opens a file and returns it as a file object. With this file object you can create, update, read, and delete files.
Read more about file handling here.
Syntax
open(file,mode,buffering,encoding,errors,newline,closefd,opener)
| Parameter | Condition | Description |
| file | Required | The path and name of the file |
| mode | Optional | Specifies the mode you want to open the file in |
| buffering | Optional | Sets the buffering policy |
| encoding | Optional | Specifies encoding |
| errors | Optional | Specifies different error handling scheme |
| newline | Optional | Controls how universal newlines mode works |
| closefd | Optional | Keeps the underlying file descriptor open when the file is closed |
| opener | Optional | A custom opener used for low-level I/O operations |
Open a File
You can open a file using open() built-in function specifying its name.
f = open('myfile.txt')When you specify the filename only, it is assumed that the file is located in the same folder as Python. If it is somewhere else, you can also specify the exact path that the file is located at.
# Specifying absolute path
f = open(r'C:\Python33\Scripts\myfile.txt')Remember! While specifying the exact path, characters prefaced by \ (like \n \r \t etc.) are interpreted as special characters.
You can escape them using:
- raw strings like
r'C:\new\text.txt' - double backslashes like
'C:\\new\\text.txt'
Specify File Mode
Here are five different modes you can use to open the file:
| Character | Mode | Description |
| ‘r’ | Read (default) | Open a file for read only |
| ‘w’ | Write | Open a file for write only (overwrite) |
| ‘a’ | Append | Open a file for write only (append) |
| ‘r+’ | Read+Write | open a file for both reading and writing |
| ‘x’ | Create | Create a new file |
You can also specify how the file should be handled.
| Character | Mode | Description |
| ‘t’ | Text (default) | Read and write strings from and to the file. |
| ‘b’ | Binary | Read and write bytes objects from and to the file.This mode is used for all files that don’t contain text (e.g. images). |
Here are some examples:
# Open a file for reading
f = open('myfile.txt')
# Open a file for writing
f = open('myfile.txt', 'w')
# Open a file for reading and writing
f = open('myfile.txt', 'r+')
# Open a binary file for reading
f = open('myfile.txt', 'rb')Because read mode ‘r’ and text mode ‘t’ are default modes, you do not need to specify them.
Specify Encoding
By specifying encoding parameter, you can decode or encode the file in popular encoding like 'ascii', 'UTF-8' etc.
# Read a file in 'UTF-8' encoding
f = open('myfile.txt', encoding='UTF-8')# Read a file in 'ascii' encoding
f = open('myfile.txt', encoding='ascii')Handling Encoding and Decoding Errors
By default, Python raises UnicodeError exception on encoding or decoding errors. However, you can specify how these errors are to be handled using errors parameter.
Below table specifies different error handling schemes.
| Parameter value | Description |
| ‘strict’ (Default) | raises an UnicodeError exception on failure |
| ‘backslashreplace’ | the unencodable character is replaced by a backslash |
| ‘ignore’ | the unencodable character is ignored |
| ‘namereplace’ | the unencodable character is replaced by its name |
| ‘replace’ | the unencodable character is replaced by questionmark |
| ‘xmlcharrefreplace’ | the unencodable character is replaced by an xml character |
Following example shows how the German letter ß is ignored while reading the file in 'ascii' encoding.
Das straße# Read a file in 'ascii' and ignore decoding errors
f = open('myfile.txt', encoding='ascii', errors='ignore')
print(f.read())
# Prints Das strae