©
本文档使用 PHP中文网手册 发布
import "compress/zlib"
概述
索引
示例
打包 zlib 实现了读取和写入zlib格式压缩数据,如 RFC 1950中所述。
实现提供了在读取和压缩期间解压缩的过滤器。例如,要将压缩数据写入缓冲区:
var b bytes.Buffer w := zlib.NewWriter(&b)w.Write([]byte("hello, world\n"))w.Close()
并读回数据:
r, err := zlib.NewReader(&b)io.Copy(os.Stdout, r)r.Close()
Constants(常量)
Variables(变量)
func NewReader(r io.Reader) (io.ReadCloser, error)
func NewReaderDict(r io.Reader, dict []byte) (io.ReadCloser, error)
type Resetter
type Writer
func NewWriter(w io.Writer) *Writer
func NewWriterLevel(w io.Writer, level int) (*Writer, error)
func NewWriterLevelDict(w io.Writer, level int, dict []byte) (*Writer, error)
func (z *Writer) Close() error
func (z *Writer) Flush() error
func (z *Writer) Reset(w io.Writer)
func (z *Writer) Write(p []byte) (n int, err error)
NewReader NewWriter
reader.go writer.go
这些常量是从 flate 包中复制的,因此导入“compress/zlib”的代码不需要导入“compress/flate”。
const ( NoCompression = flate.NoCompression BestSpeed = flate.BestSpeed BestCompression = flate.BestCompression DefaultCompression = flate.DefaultCompression HuffmanOnly = flate.HuffmanOnly)
var ( // 读取具有无效校验和的ZLIB数据时会返回ErrChecksum。 ErrChecksum = errors.New("zlib: invalid checksum") // 读取具有无效字典的ZLIB数据时,会返回ErrDictionary。 ErrDictionary = errors.New("zlib: invalid dictionary") // 读取包含无效标题的ZLIB数据时,会返回ErrHeader。 ErrHeader = errors.New("zlib: invalid header"))
func NewReader(r io.Reader) (io.ReadCloser, error)
NewReader 创建一个新的 ReadCloser。从返回的 ReadCloser 读取并解压缩来自r的数据。如果 r 没有实现 io.ByteReader,解压缩程序可能会读取比r更多的数据。调用者有责任在完成时调用ReadCloser 上的 Close。
NewReader 返回的 ReadCloser 也实现了 Resetter。
package mainimport ("bytes""compress/zlib""io""os")func main() { buff := []byte{120, 156, 202, 72, 205, 201, 201, 215, 81, 40, 207,47, 202, 73, 225, 2, 4, 0, 0, 255, 255, 33, 231, 4, 147} b := bytes.NewReader(buff) r, err := zlib.NewReader(b)if err != nil {panic(err)} io.Copy(os.Stdout, r) r.Close()}
func NewReaderDict(r io.Reader, dict []byte) (io.ReadCloser, error)
NewReaderDict 与 NewReader 类似,但使用预设字典。如果压缩数据没有引用它,NewReaderDict 会忽略该字典。如果压缩数据引用不同的字典,则 NewReaderDict 返回 ErrDictionary。
NewReaderDict 返回的 ReadCloser 也实现了 Resetter。
重置器重置由 NewReader 或 NewReaderDict 返回的 ReadCloser 以切换到新的底层 Reader。这允许重新使用 ReadCloser 而不是分配新的。
type Resetter interface { // 重置会丢弃任何缓冲数据,并将重置器重置为好像它一样 // 最新与给定的读者初始化。 Reset(r io.Reader, dict []byte) error}
Writer 将写入数据的数据写入底层写入器(请参阅 NewWriter)。
type Writer struct { // 包含过滤或未导出的字段}
func NewWriter(w io.Writer) *Writer
NewWriter 创建一个新的 Writer。写入返回的 Writer 被压缩并写入 w。
调用者有责任在完成时调用 WriteCloser 上的 Close。写入可能会被缓冲,直到关闭才会被刷新。
package mainimport ("bytes""compress/zlib""fmt")func main() {var b bytes.Buffer w := zlib.NewWriter(&b) w.Write([]byte("hello, world\n")) w.Close() fmt.Println(b.Bytes())}
func NewWriterLevel(w io.Writer, level int) (*Writer, error)
NewWriterLevel 就像 NewWriter,但指定压缩级别而不是假设 DefaultCompression。
压缩级别可以是DefaultCompression,NoCompression, HuffmanOnly 或 BestSpeed 和 BestCompression 之间的任何整数值。如果级别有效,返回的错误将为零。
func NewWriterLevelDict(w io.Writer, level int, dict []byte) (*Writer, error)
NewWriterLevelDict 与 NewWriterLevel 类似,但指定要压缩的字典。
字典可能是零。如果没有,则在 Writer 关闭之前不应修改其内容。
func (z *Writer) Close() error
关闭Writer,将任何未写入的数据刷新到基础 io.Writer,但不关闭基础 io.Writer。
func (z *Writer) Flush() error
Flush Writer 到其基础 io.Writer。
func (z *Writer) Reset(w io.Writer)
重置清除Writer z 的状态,使其等于 NewWriterLevel 或 NewWriterLevelDict 的初始状态,并且写入 w。
func (z *Writer) Write(p []byte) (n int, err error)
写入一个压缩形式的 p 到底层的 io.Writer 。在写入器关闭或明确刷新之前,压缩的字节不一定会被刷新。