encoding/asn1

import "encoding/asn1"

概述

索引

概述

按照 ITU-T Rec X.690 的规定，asn1 包实现了对 DER 编码的 ASN.1 数据结构的解析。

另见“ ASN.1，BER 和 DER 子集的外行指南”，http：//luca.ntop.org/Teaching/Appunti/asn1.html。

索引

常量

变量

func Marshal(val interface{}) ([]byte, error)

func Unmarshal(b []byte, val interface{}) (rest []byte, err error)

func UnmarshalWithParams(b []byte, val interface{}, params string) (rest []byte, err error)

type BitString

func (b BitString) At(i int) int

func (b BitString) RightAlign() []byte

type Enumerated

type Flag

type ObjectIdentifier

func (oi ObjectIdentifier) Equal(other ObjectIdentifier) bool

func (oi ObjectIdentifier) String() string

type RawContent

type RawValue

type StructuralError

func (e StructuralError) Error() string

type SyntaxError

func (e SyntaxError) Error() string

包文件

asn1.go common.go marshal.go

常量

ASN.1 标签表示以下对象的类型。

const (
        TagBoolean         = 1
        TagInteger         = 2
        TagBitString       = 3
        TagOctetString     = 4
        TagNull            = 5
        TagOID             = 6
        TagEnum            = 10
        TagUTF8String      = 12
        TagSequence        = 16
        TagSet             = 17
        TagPrintableString = 19
        TagT61String       = 20
        TagIA5String       = 22
        TagUTCTime         = 23
        TagGeneralizedTime = 24
        TagGeneralString   = 27
)

ASN.1 类类型表示标签的名称空间。

const (
        ClassUniversal       = 0
        ClassApplication     = 1
        ClassContextSpecific = 2
        ClassPrivate         = 3
)

变量

NullBytes 包含表示 DER 编码的 ASN.1 NULL 类型的字节。

var NullBytes = []byte{TagNull, 0}

NullRawValue 是一个 RawValue，其标签设置为 ASN.1 NULL 类型 tag(5)。

var NullRawValue = RawValue{Tag: TagNull}

func Marshal（查看源代码）

func Marshal(val interface{}) ([]byte, error)

Marshal 返回 val 的 ASN.1 编码。

除了由 Unmarshal 识别的结构标签之外，还可以使用以下内容：

ia5：导致字符串被封送为ASN.1，IA5String值
omitempty：导致跳过空切片
printable：导致字符串被封送为ASN.1，PrintableString值
utf8：导致字符串被封送为ASN.1，UTF8String值
utc：导致time.Time被封送为ASN.1，UTCTime值
generalized：导致time.Time被封送为ASN.1，GeneralizedTime值

func Unmarshal（查看源代码）

func Unmarshal(b []byte, val interface{}) (rest []byte, err error)

Unmarshal 分析 DER 编码的 ASN.1 数据结构 b 并使用反射包填充 val 指向的任意值。由于 Unmarshal 使用反射包，因此写入的结构必须使用大写字段名称。

ASN.1 INTEGER 可以写入 int，int32，int64 或 *big.Int（来自 math/big package）。如果编码值不适合 Go 类型，Unmarshal 会返回解析错误。

一个 ASN.1 BIT STRING 可以写入一个 BitString。

ASN.1 OCTET STRING 可以写入 []byte。

一个 ASN.1 OBJECT IDENTIFIER 可以写入一个 ObjectIdentifier。

一个 ASN.1 枚举可以被写入枚举。

一次 ASN.1 UTCTIME 或 GENERALIZEDTIME 可写入一次。

ASN.1 PrintableString 或 IA5String 可写入字符串。

任何上面的 ASN.1 值都可以写入 interface{}。存储在接口中的值具有相应的 Go 类型。对于整数，该类型是 int64。

如果可以将 x 写入片段的元素类型，则可以将 x 或 x 的 ASN.1 序列写入片段。

如果可以将序列中的每个元素写入结构中的相应元素，则可以将 ASN.1 SEQUENCE 或 SET 写入结构。

结构字段上的以下标记对 Unmarshal 具有特殊意义：

application指定使用APPLICATION标记
default：x设置可选整数字段的默认值（仅在可选的整数字段存在时使用）
explicit指定附加的显式标记包装隐式标记
可选标记该字段为ASN.1可选
set会导致SET，而不是SEQUENCE类型
tag：x指定ASN.1标记号; 暗示ASN.1特定背景

如果结构的第一个字段的类型是 RawContent，那么该结构的原始 ASN1 内容将被存储在其中。

如果一个切片元素的类型名称以“SET”结尾，那么它将被视为设置了“set”标签。这可以用于无法给出 struct 标记的嵌套切片。

其他 ASN.1 类型不受支持；如果遇到，Unmarshal 将返回一个分析错误。

func UnmarshalWithParams（查看源代码）

func UnmarshalWithParams(b []byte, val interface{}, params string) (rest []byte, err error)

UnmarshalWithParams 允许为顶层元素指定字段参数。参数的形式与字段标签相同。

type BitString（查看源代码）

当您需要 ASN.1 BIT STRING 类型时，BitString 是要使用的结构。位串被填充到内存中最近的字节并记录有效位的数量。填充位将为零。

type BitString struct {
        Bytes     []byte // 比特打包成字节。
        BitLength int    // 比特长度。
}

func (BitString) At（查看源代码）

func (b BitString) At(i int) int

返回给定索引处的位。如果索引超出范围，则返回 false。

func (BitString) RightAlign（查看源代码）

func (b BitString) RightAlign() []byte

RightAlign 返回填充位在开始位置的片。切片可以与 BitString 共享内存。

type Enumerated（查看源代码）

Enumerated 被表示为一个纯（plain） int。

type Enumerated int

type Flag（查看源代码）

Flag 接受任何数据，如果存在则设置为 true。

type Flag bool

type ObjectIdentifier（查看源代码）

一个 ObjectIdentifier 表示一个 ASN.1 对象标识符。

type ObjectIdentifier []int

func (ObjectIdentifier) Equal（查看源代码）

func (oi ObjectIdentifier) Equal(other ObjectIdentifier) bool

平等报告 oi 和其他是否表示相同的标识符。

func (ObjectIdentifier) String（查看源代码）

func (oi ObjectIdentifier) String() string

type RawContent（查看源代码）

RawContent 用于表示未解码的 DER 数据需要为结构体保留。要使用它，结构的第一个字段必须有这种类型。任何其他字段都有这种类型的错误。

type RawContent []byte

type RawValue（查看源代码）

一个 RawValue 表示一个未解码的 ASN.1 对象。

type RawValue struct {
        Class, Tag int
        IsCompound bool
        Bytes      []byte
        FullBytes  []byte // 包括标签和长度
}

type StructuralError（查看源代码）

StructuralError 表明 ASN.1 数据是有效的，但是接收它的 Go 类型不匹配。

type StructuralError struct {
        Msg string
}

func (StructuralError) Error（查看源代码）

func (e StructuralError) Error() string

type SyntaxError（查看源代码）

SyntaxError 表明 ASN.1 数据无效。

type SyntaxError struct {
        Msg string
}

func (SyntaxError) Error（查看源代码）

func (e SyntaxError) Error() string

本文档系腾讯云开发者社区成员共同维护，如有问题请联系 cloudcommunity@tencent.com

最后更新于：2017-12-18