Software: Apache/2.0.54 (Unix) mod_perl/1.99_09 Perl/v5.8.0 mod_ssl/2.0.54 OpenSSL/0.9.7l DAV/2 FrontPage/5.0.2.2635 PHP/4.4.0 mod_gzip/2.0.26.1a 

uname -a: Linux snow.he.net 4.4.276-v2-mono-1 #1 SMP Wed Jul 21 11:21:17 PDT 2021 i686 

uid=99(nobody) gid=98(nobody) groups=98(nobody) 

Safe-mode: OFF (not secure)

/usr/doc/python-2.2.3/html/lib/   drwxr-xr-x
Free 318.38 GB of 458.09 GB (69.5%)
                            Encoder    Tools    Proc.    FTP brute    Sec.    SQL    PHP-code    Update    Feedback    Self remove    Logout    

Viewing file:     module-xreadlines.html (5.9 KB)      -rw-r--r--

Python Library Reference

Previous: 5.11 fileinput Up: 5. Miscellaneous Services Next: 5.13 calendar

---

5.12 xreadlines -- Efficient iteration over a file

New in version 2.1.

This module defines a new object type which can efficiently iterate over the lines of a file. An xreadlines object is a sequence type which implements simple in-order indexing beginning at 0, as required by for statement or the filter() function.

Thus, the code

import xreadlines, sys

for line in xreadlines.xreadlines(sys.stdin):
    pass

has approximately the same speed and memory consumption as

while 1:
    lines = sys.stdin.readlines(8*1024)
    if not lines: break
    for line in lines:
        pass

except the clarity of the for statement is retained in the former case.

xreadlines(fileobj)

Return a new xreadlines object which will iterate over the contents of fileobj. fileobj must have a readlines() method that supports the sizehint parameter. Note: Because the readlines() method buffers data, this effectively ignores the effects of setting the file object as unbuffered.

An xreadlines object s supports the following sequence operation:

Operation	Result
s[i]	i'th line of s

If successive values of i are not sequential starting from 0, this code will raise RuntimeError.

After the last line of the file is read, this code will raise an IndexError.

---

Python Library Reference

Previous: 5.11 fileinput Up: 5. Miscellaneous Services Next: 5.13 calendar

---

Release 2.2.3, documentation updated on 30 May 2003.