bzclose

关闭一个 bzip2 文件

说明

int bzclose ( resource $bz )

关闭给出的 bzip2 文件指针。

参数

bz
文件指针。它必须是有效的并且指向 bzopen 成功打开的文件。

返回值

成功时返回 TRUE, 或者在失败时返回 FALSE

参见

  • bzopen

bzcompress

把一个字符串压缩成 bzip2 编码数据

说明

mixed bzcompress ( string $source [, int $blocksize = 4 [, int $workfactor = 0 ]] )

bzcompress 压缩了指定的字符串并以 bzip2 编码返回数据。

参数

source
待压缩的字符串。

blocksize
指定压缩时使用的块大小,应该是一个 1-9 的数字。9 可以有最高的压缩比,但会使用更多的资源。

workfactor
控制压缩阶段出现最坏的重复性高的情况下输入数据时的行为。 该值可以是在 0 至 250 之间,0是一个特殊的情况。

无论 workfactor是什么,产生的输出都是一致的。

返回值

压缩后的字符串,或者在出现错误时返回错误号。

范例

示例 #1 压缩数据

<?php
$str = "sample data";
$bzstr = bzcompress($str, 9);
echo $bzstr;
?>

参见

  • bzdecompress

bzdecompress

解压经 bzip2 编码过的数据

说明

mixed bzdecompress ( string $source [, int $small = 0 ] )

bzdecompress 解压了包含 bzip2 压缩数据的指定字符串。

参数

source
要解压的字符串。

small
如果为 TRUE,将会使用一种内存开销更小的替代算法(最大内存需求降低至大约 2300K)但速度会降低约一半。

寻找该功能的更多信息可参见 » bzip2 文档

返回值

解压后的字符串,如果发生了一个错误则返回一个错误码。

范例

示例 #1 解压一个字符串

<?php
$start_str = "This is not an honest face?";
$bzstr = bzcompress($start_str);

echo "Compressed String: ";
echo $bzstr;
echo "\n<br />\n";

$str = bzdecompress($bzstr);
echo "Decompressed String: ";
echo $str;
echo "\n<br />\n";
?>

参见

  • bzcompress

bzerrno

返回一个 bzip2 错误码

说明

int bzerrno ( resource $bz )

返回指定文件指针任意返回的 bzip2 错误的错误码。

参数

bz
文件指针。它必须是有效的并且指向 bzopen 成功打开的文件。

返回值

返回 integer 的错误码。

参见

  • bzerror
  • bzerrstr

bzerror

返回包含 bzip2 错误号和错误字符串的一个 array

说明

array bzerror ( resource $bz )

返回文件指针中返回的 bzip2 错误的错误号和错误字符串。

参数

bz
文件指针。它必须是有效的并且指向 bzopen 成功打开的文件。

返回值

返回一个关联数组,包含错误码于 errno 条目, 以及错误信息于 errstr 条目。

范例

示例 #1 bzerror 范例

<?php
$error = bzerror($bz);

echo $error["errno"];
echo $error["errstr"];
?>

参见

  • bzerrno
  • bzerrstr

bzerrstr

返回一个 bzip2 的错误字符串

说明

string bzerrstr ( resource $bz )

获取指定文件指针中返回 bzip2 任何错误的错误字符串。

参数

bz
文件指针。它必须是有效的并且指向 bzopen 成功打开的文件。

返回值

返回包含错误信息的 string。

参见

  • bzerrno
  • bzerror

bzflush

强制写入所有写缓冲区的数据

说明

bool bzflush ( resource $bz )

强制写入 bzip2 文件指针 bz 的所有写缓冲数据。

参数

bz
文件指针。它必须是有效的并且指向 bzopen 成功打开的文件。

返回值

成功时返回 TRUE, 或者在失败时返回 FALSE

参见

  • bzread
  • bzwrite

bzopen

打开 bzip2 压缩文件

说明

resource bzopen ( mixed $file , string $mode )

bzopen 打开一个 bzip2(.bz2)文件用于读或写。

参数

file
待打开的文件的文件名,或者已经存在的资源流。

mode
支持 'r'(读)和 'w'(写)模式。 其他任何模式都会导致 bzopen 返回 FALSE

返回值

如果打开失败,bzopen 会返回 FALSE,否则返回一个指向最新打开文件的指针。

范例

示例 #1 bzopen 范例

<?php

$file = "/tmp/foo.bz2";
$bz = bzopen($file, "r") or die("Couldn't open $file for reading");

bzclose($bz);

?>

参见

  • bzclose

bzread

bzip2 文件二进制安全地读取

说明

string bzread ( resource $bz [, int $length = 1024 ] )

bzread 从指定的 bzip2 文件指针中读取数据。

读取到 length(未经压缩的长度)个字节,或者到文件尾,取决于先到哪个。

参数

bz
文件指针。它必须是有效的并且指向 bzopen 成功打开的文件。

length
如果没有提供, bzread 一次会读入 1024 个字节(未经压缩的长度)。 一次最大可读入 8192 个未压缩的字节。

返回值

返回解压的数据,在错误时返回 FALSE

范例

示例 #1 bzread 范例

<?php

$file = "/tmp/foo.bz2";
$bz = bzopen($file, "r") or die("Couldn't open $file");

$decompressed_file = '';
while (!feof($bz)) {
  $decompressed_file .= bzread($bz, 4096);
}
bzclose($bz);

echo "The contents of $file are: <br />\n";
echo $decompressed_file;

?>

参见

  • bzwrite
  • feof
  • bzopen

bzwrite

二进制安全地写入 bzip2 文件

说明

int bzwrite ( resource $bz , string $data [, int $length ] )

bzwrite 把字符串(string)写入了指定的 bzip2 文件流。

参数

bz
文件指针。它必须是有效的并且指向 bzopen 成功打开的文件。

data
要写入的数据。

length
如果提供了这个参数,将仅仅写入 length(未压缩)个字节,若 data 小于该指定的长度则写入全部数据。

返回值

返回写入的数据字节数,错误时返回 FALSE

范例

示例 #1 bzwrite 范例

<?php
$str = "uncompressed data";
$bz = bzopen("/tmp/foo.bz2", "w");
bzwrite($bz, $str, strlen($str));
bzclose($bz);
?>

参见

  • bzread
  • bzopen

目录

  • bzclose — 关闭一个 bzip2 文件
  • bzcompress — 把一个字符串压缩成 bzip2 编码数据
  • bzdecompress — 解压经 bzip2 编码过的数据
  • bzerrno — 返回一个 bzip2 错误码
  • bzerror — 返回包含 bzip2 错误号和错误字符串的一个 array
  • bzerrstr — 返回一个 bzip2 的错误字符串
  • bzflush — 强制写入所有写缓冲区的数据
  • bzopen — 打开 bzip2 压缩文件
  • bzread — bzip2 文件二进制安全地读取
  • bzwrite — 二进制安全地写入 bzip2 文件