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)

/opt/doc/python-2.3.4/html/Python-Docs-2.3.4/lib/   drwxr-xr-x
Free 318.34 GB of 458.09 GB (69.49%)
                            Encoder    Tools    Proc.    FTP brute    Sec.    SQL    PHP-code    Update    Feedback    Self remove    Logout    

Viewing file:     module-linecache.html (7.08 KB)      -rw-r--r--

Python Library Reference

Previous: 3.12.1 Traceback Example Up: 3. Python Runtime Services Next: 3.14 pickle

---

3.13 linecache -- Random access to text lines

The linecache module allows one to get any line from any file, while attempting to optimize internally, using a cache, the common case where many lines are read from a single file. This is used by the traceback module to retrieve source lines for inclusion in the formatted traceback.

The linecache module defines the following functions:

getline(

filename, lineno)

Get line lineno from file named filename. This function will never throw an exception -- it will return '' on errors (the terminating newline character will be included for lines that are found).

If a file named filename is not found, the function will look for it in the module search path, sys.path.

clearcache(

)

Clear the cache. Use this function if you no longer need lines from files previously read using getline().

checkcache(

)

Check the cache for validity. Use this function if files in the cache may have changed on disk, and you require the updated version.

Example:

>>> import linecache
>>> linecache.getline('/etc/passwd', 4)
'sys:x:3:3:sys:/dev:/bin/sh\n'

---

Python Library Reference

Previous: 3.12.1 Traceback Example Up: 3. Python Runtime Services Next: 3.14 pickle

---

Release 2.3.4, documentation updated on May 20, 2004.