Documentation
¶
Overview ¶
Package xml declares the error codes and the sentinels of the XML codec, internal/service/data/codec/xml — range 0.3.3.* (ADR 0005 service/data/codec/xml block).
The codes live in the core at the path that mirrors the package emitting them (ADR 0160 §2) and keep the values they were allocated with: the LL byte 3 records the layer that allocated the range, not the directory that declares it today (ADR 0160 §3). Nothing here encodes or decodes — the mechanism, and the constructors that attach a failure's detail, stay in the service package.
Package xml — the sentinel *errs.Error values, one per code. Each Reason derives from its var name or from its Code constant (ADR 0020); the Public and Private texts are the ones the service package always emitted, so moving the declaration changed no rendering.
Index ¶
Constants ¶
const CodeXMLMarshalFailed errs.Code = 0x00_03_03_01 // 0.3.3.1
CodeXMLMarshalFailed identifies a failure inside encoding/xml.Marshal.
const CodeXMLSizeExceeded errs.Code = 0x00_03_03_03 // 0.3.3.3
CodeXMLSizeExceeded identifies a value refused by NewBoundedDecoder for its byte ceiling: longer than the bound the caller set (#891). Its reason is the family's SIZE_EXCEEDED (#894).
const CodeXMLUnmarshalFailed errs.Code = 0x00_03_03_02 // 0.3.3.2
CodeXMLUnmarshalFailed identifies a failure inside encoding/xml.Unmarshal.
Variables ¶
var ( // MarshalFailed wraps a failure from encoding/xml.Marshal. MarshalFailed = errs.Static(CodeXMLMarshalFailed, "MARSHAL_FAILED", "XML encoding failed", "service/data/codec/xml: encoding/xml.Marshal returned an error", 0, 0) // UnmarshalFailed wraps a failure from encoding/xml.Unmarshal. UnmarshalFailed = errs.Static(CodeXMLUnmarshalFailed, "UNMARSHAL_FAILED", "XML decoding failed", "service/data/codec/xml: encoding/xml.Unmarshal returned an error", 0, 0) // SizeExceeded is the refusal of a value longer than NewBoundedDecoder's byte ceiling (#891). SizeExceeded = errs.Static(CodeXMLSizeExceeded, "SIZE_EXCEEDED", "XML input exceeds a size limit", "service/data/codec/xml: a value in the stream is longer than the decoder's byte ceiling", 0, 0) )
Functions ¶
This section is empty.
Types ¶
This section is empty.