Python read file
Python read file tutorial shows how to read files in Python. We show several examples that read text and binary files.
If we want to read a file, we need to open it first. For this, Python has the built-in open function.
Python open function
The open function is used to open files in Python.
open(file, mode='r', buffering=-1, encoding=None, errors=None, newline=None)
The file is the name of the file to be opened. The mode indicates how the file is going to be opened: for reading, writing, or appending. The buffering is an optional integer used to set the buffering policy. The encoding is the name of the encoding used to decode or encode the file. The errors is an optional string that specifies how encoding and decoding errors are to be handled. The newline controls the behaviour of the newline character.
First, we deal with text files. At the end of the tutorial, we work with a binary file.
Lost Illusions Beatrix Honorine The firm of Nucingen Old Goriot Colonel Chabert Cousin Bette Gobseck César Birotteau The Chouans
We use this file for reading text.
Python read
The read function reads at most size characters as a single string. If the size parameter is negative, it reads until EOF.
#!/usr/bin/python with open('works.txt', 'r') as f: contents = f.read() print(contents) The example reads the whole file and prints its contents.
We open the works.txt file in the read mode. Since we did not specify the binary mode, the file is opened in the default text mode. It returns the file object f . The with statement simplifies exception handling by encapsulating common preparation and cleanup tasks. It also automatically closes the opened file.
We call the file object’s read function. Since we did not specify any parameter, it reads the whole file.
$ ./read_all.py Lost Illusions Beatrix Honorine The firm of Nucingen Old Goriot Colonel Chabert Cousin Bette Gobseck César Birotteau The Chouans
Python read characters
By providing the size parameter to the read function, we can specify how many characters we want to read.
#!/usr/bin/python with open('works.txt', 'r') as f: data1 = f.read(4) print(data1) data2 = f.read(20) print(data2) data3 = f.read(10) print(data3) In the example, we read 4, 20, and 10 characters from the file.
$ ./read_characters.py Lost Illusions Beatrix H onorine Th
Python readline
The readline function reads until newline or EOF and return a single string. If the stream is already at EOF, an empty string is returned. If the size parameter is specified, at most size characters will be read.
#!/usr/bin/python with open('works.txt', 'r') as f: line = f.readline() print(line.rstrip()) line2 = f.readline() print(line2.rstrip()) line3 = f.readline() print(line3.rstrip()) In the example, we read three lines from the file. The rstrip function cuts the trailing newline character from the string.
$ ./read_line.py Lost Illusions Beatrix Honorine
Python readlines
The readlines function reads and returns a list of lines from the stream.
#!/usr/bin/python with open('works.txt', 'r') as f: lines = f.readlines() print(lines) for line in lines: print(line.strip()) In the example, we read the contents of the file with readlines . We print the list of the lines and then loop over the list with a for statement.
$ ./read_lines.py ['Lost Illusions\n', 'Beatrix\n', 'Honorine\n', 'The firm of Nucingen\n', 'Old Goriot\n', 'Colonel Chabert\n', 'Cousin Bette\n', 'Gobseck\n', 'César Birotteau\n', 'The Chouans\n'] Lost Illusions Beatrix Honorine The firm of Nucingen Old Goriot Colonel Chabert Cousin Bette Gobseck César Birotteau The Chouans
Python read file
Since the file object returned from the open function is a iterable, we can pass it directly to the for statement.
#!/usr/bin/python with open('works.txt', 'r') as f: for line in f: print(line.rstrip()) The example iterates over the file object to print the contents of the text file.
$ ./read_file.py Lost Illusions Beatrix Honorine The firm of Nucingen Old Goriot Colonel Chabert Cousin Bette Gobseck César Birotteau The Chouans
The seek function
The seek function changes the stream position to the given byte offset.
The offset value is interpreted relative to the position indicated by whence . The default value for whence is SEEK_SET .
- SEEK_SET or 0 – start of the stream (the default); offset should be zero or positive
- SEEK_CUR or 1 – current stream position; offset may be negative
- SEEK_END or 2 – end of the stream; offset is usually negative
#!/usr/bin/python with open('works.txt', 'r') as f: data1 = f.read(22) print(data1) f.seek(0, 0) data2 = f.read(22) print(data2) In the example, we read 22 characters from a text stream. Then we set the stream position back to the beginning and read 22 characters again.
$ ./seeking.py Lost Illusions Beatrix Lost Illusions Beatrix
The tell function
The tell function returns the current stream position.
#!/usr/bin/python with open('works.txt', 'r') as f: print(f'The current file position is ') f.read(22) print(f'The current file position is ') f.seek(0, 0) print(f'The current file position is ') We move the stream position with read and seek and print it with tell .
$ ./telling.py The current file position is 0 The current file position is 22 The current file position is 0
Python read file with try/except/finally
The with statement simplifies our work when reading files. Without with , we need to manually handle exceptions and close the resources.
#!/usr/bin/python f = None try: f = open('works.txt', 'r') for line in f: print(line.rstrip()) except IOError as e: print(e) finally: if f: f.close() In the example, we deal with the exceptions and resource release using try , except , and finally keywords.
Python read binary file
In the following example, we read a binary file.
#!/usr/bin/python with open('web.png', 'rb') as f: hexdata = f.read().hex() n = 2 data = [hexdata[i:i+n] for i in range(0, len(hexdata), n)] i = 0 for e in data: print(e, end=' ') i += 1 if i % 20 == 0: print() print() The example reads a PNG file. It outputs the data as hexadecimal values.
We open the PNG file in read and binary modes.
We read all data and turn it into hexadecimal values with hex function.
n = 2 data = [hexdata[i:i+n] for i in range(0, len(hexdata), n)]
We chunk the string into a list of two characters.
i = 0 for e in data: print(e, end=' ') i += 1 if i % 20 == 0: print()
We print the data in columns; there is a space between the columns. There are 20 columns per line of output.
$ ./read_binary.py 89 50 4e 47 0d 0a 1a 0a 00 00 00 0d 49 48 44 52 00 00 00 10 00 00 00 10 08 06 00 00 00 1f f3 ff 61 00 00 03 2a 49 44 41 54 78 01 75 53 43 98 23 69 18 ae eb 7a af eb 4a c6 b6 ed 38 19 bb b5 6c db 66 55 45 dd 71 66 9f a4 ad 8a 9d b1 6d e3 fe ac 77 2f 63 bf 5b 55 a7 e1 e1 c7 a7 f7 33 01 e0 b5 43 6a 1a 3e 27 e5 6d a9 62 b9 d6 39 4a a5 bd 3e 4a ad bb 22 56 d2 76 .
In this tutorial we have showed how to read files in Python.
Author
My name is Jan Bodnar and I am a passionate programmer with many years of programming experience. I have been writing programming articles since 2007. So far, I have written over 1400 articles and 8 e-books. I have over eight years of experience in teaching programming.