package ascii85

import "encoding/ascii85"

Package ascii85 实现 ascii85 数据编码, 该编码用于 btoa 工具以及 Adobe 的 PostScript 和 PDF 文档格式。

Index

Functions

func Decode

func Decode(dst, src []byte, flush bool) (ndst, nsrc int, err error)

Decode 将 src 解码到 dst,同时返回写入 dst 的字节数 和从 src 消耗的字节数。 如果 src 包含无效的 ascii85 数据,Decode 将返回成功写入的 字节数和一个 CorruptInputError。 Decode 会忽略 src 中的空格和控制字符。 ascii85 编码的数据通常被包裹在 <~ 和 ~> 符号中。 Decode 假定调用方已去除这些符号。

如果 flush 为 true,Decode 假定 src 表示输入流的结尾, 并完整地处理它,而不是等待另一个 32 位块完成。

NewDecoder 在 Decode 之上封装了一个 io.Reader 接口。

func Encode

func Encode(dst, src []byte) int

Encode 将 src 编码到 dst 的至多 MaxEncodedLen(len(src)) 个字节中,并返回实际写入的字节数。

该编码以 4 字节为块进行处理,对最后一个片段使用特殊编码, 因此 Encode 不适合用于大型数据流的单独块。请改用 NewEncoder。

ascii85 编码的数据通常被包裹在 <~ 和 ~> 符号中。 Encode 不会添加这些符号。

func MaxEncodedLen

func MaxEncodedLen(n int) int

MaxEncodedLen 返回 n 个源字节编码后的最大长度。

func NewDecoder

func NewDecoder(r io.Reader) io.Reader

NewDecoder 构造一个新的 ascii85 流解码器。

func NewEncoder

func NewEncoder(w io.Writer) io.WriteCloser

NewEncoder 返回一个新的 ascii85 流编码器。写入所返回 writer 的数据 将被编码,然后写入 w。 Ascii85 编码以 32 位块为操作单位;写入完成后, 调用方必须对所返回的编码器调用 Close 以刷新任何尾部残缺块。

Types

type CorruptInputError

type CorruptInputError int64
func (CorruptInputError) Error
func (e CorruptInputError) Error() string