PEAR マニュアル
前のページ		次のページ

Archive_Tar::extractList()

Archive_Tar::extractList() -- リスとされたファイルを伸長する

概要

require_once 'Archive/Tar.php';

boolean extractList (array $filelist [, string $path = '' [, string $remove_path = '']])

説明

このメソッドは $filelist で指定されたファイルのみをアーカイブから伸長します。これらのファイルはカレントディレクトリもしくはオプションの $path パラメータで指定されたディレクトリに伸長されます。

パラメータ

string $filelist - ファイル名やディレクトリ名の配列、もしくはスペースで区切られた単一の文字列を指定します。
string $path - ファイルやディレクトリを伸長するために必要なディレクトリのパスを指定します。
string $remove_path - ファイルやディレクトリパスの最初に現れる場合に削除する記録されたパスの一部を指定します

返り値

boolean - 成功時には TRUE 、失敗時には FALSE を返します。

例外・エラー

表 44-1PEAR_Error の値

エラーコード	エラーメッセージ	理由	解決法
`NULL`	" Unable to open in read mode `archive` "	ファイルが他のアプリケーションによって排他的にロックされています。	当該ファイルを使用している他のアプリケーションを確認してください。これは競合する Archive_Tar でアーカイブを処理している場合は発生しません。
`NULL`	" Unable to open in write mode `archive` "	ファイルが他のアプリケーションによってロックされています。	当該ファイルを使用している他のアプリケーションを確認してください。これは競合する Archive_Tar でアーカイブを処理している場合に発生するかも知れません。
`NULL`	" Invalid extractlist mode `mode` "	実装エラーです。	発生しないはずですが、その場合はバグレポートをお願いします。
`NULL`	" Directory `name` already exists as a file "	そのファイルはアーカイブ中でディレクトリとしてマークされています。	壊れたアーカイブなのかも知れません
`NULL`	" File `name` already exists as a directory "	そのディレクトリはアーカイブ中でファイルとしてマークされています。	壊れたアーカイブなのかも知れません
`NULL`	" File `name` already exists and is write protected. "	アーカイブは伸長先ディレクトリにすでに存在しているファイルを含んでおり、上書きすることができません。	空のディレクトリにアーカイブを伸長してください。
`NULL`	" Unable to create path for `name` "	1 つもしくはそれ以上のネストした新規ディレクトリは伸長先ディレクトリに生成できません。	伸長先ディレクトリと全てのネストしたディレクトリが要求される権限を持っているか確認してください。
`NULL`	" Unable to create directory `name` "	ディレクトリを伸長先ディレクトリに生成することができませんでした。	伸長先ディレクトリに要求される権限を持っているか確認してください。
`NULL`	" Error while opening `name` in write binary mode "	ファイルを生成することができませんでした。	ファイルがロックされている可能性があります。
`NULL`	" Extracted file `filename` does not have the correct file size `filesize` (`size` expected). Archive may be corrupted. "	メッセージを参照してください。	メッセージを参照してください。

注意

この関数は、スタティックにコールすることはできません。

例

例 44-1圧縮されたアーカイブを伸長する

// tarname.tar は以下のファイルを含む :
//   dev/data/file.txt
//   dev/data/log.txt
//   readme.txt

$tar_object = new Archive_Tar("tarname.tar");
$tar_object->extractList("dev/data/file.txt readme.txt", "install",
                         "dev");

// 伸長されるファイルは以下の通り :
//   install/data/file.txt
//   install/readme.txt

前のページ	ホーム	次のページ
Archive_Tar::extract()	上に戻る	Archive_Tar::extractModify()