在线文档教程

linecache

linecache - 随机访问文本行

源代码: Lib / linecache.py

linecache模块允许从任何文件中获取任意行,同时尝试使用缓存进行内部优化,这是一种常见的情况,即从单个文件读取多行。这被traceback模块用来检索包含在格式化回溯中的源代码行。

linecache模块定义了以下功能:

linecache.getline(filename, lineno[, module_globals])

从文件命名文件名中获取lineno。这个函数永远不会引发异常 - 它会在错误时返回''(终止的换行符将包含在找到的行中)。

如果没有找到名为filename的文件,则该函数将在模块搜索路径中sys.path,在首先检查module_globals中PEP 302 __loader__后,在模块是从zipfile或其他非文件系统导入源导入的情况下查找它。

2.5版新增功能:添加了module_globals参数。

linecache.clearcache()

清除缓存。如果您不再需要先前读取的文件中的行,请使用此功能getline()

linecache.checkcache([filename])

检查缓存的有效性。如果缓存中的文件可能已在磁盘上发生更改,并且您需要更新的版本,请使用此功能。如果省略了filename,它将检查缓存中的所有条目。

例:

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