"linecache" — テキストラインにランダムアクセスする
**************************************************

**ソースコード:** Lib/linecache.py

======================================================================

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.

"linecache" モジュールでは次の関数が定義されています:

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

   *filename* という名前のファイルから *lineno* 行目を取得します。この
   関数は決して例外を発生させません — エラーの際には "''" を返します (
   行末の改行文字は、見つかった行に含まれます)。

   *filename* という名前のファイルが見つからなかった場合、モジュールの
   、つまり、 "sys.path" でそのファイルを探します。 zipfileやその他の
   ファイルシステムでないimport元に対応するためまず *module_globals*
   の **PEP 302** "__loader__" をチェックし、そのあと "sys.path" を探
   索します。

   バージョン 2.5 で追加: The *module_globals* parameter was added.

linecache.clearcache()

   キャッシュをクリアします。それまでに "getline()" を使って読み込んだ
   ファイルの行が必要でなくなったら、この関数を使ってください。

linecache.checkcache([filename])

   キャッシュが有効かどうかを確認します。キャッシュしたファイルがディ
   スク上で変更された可能性があり、更新後のバージョンが必要な場合にこ
   の関数を使用します。 *filename* が与えられない場合、全てのキャッシ
   ュエントリを確認します。

以下はプログラム例です:

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