Documentation
¶
Overview ¶
Package section contains binary stream manipulation utilities.
Index ¶
- Constants
- Variables
- func CopyStandardSection(w io.Writer, l Loader, id ID, ...) (length int64, err error)
- func CustomLoader(loaders map[string]CustomContentLoader) func(Reader, uint32) error
- func SkipCustomSections(l Loader, customLoader func(Reader, uint32) error) (err error)
- type ByteRange
- type CustomContentLoader
- type CustomMapping
- type CustomSections
- type FuncName
- type ID
- type Loader
- type Map
- type MappedNameSection
- type NameSection
- type Reader
Constants ¶
const ( Custom = module.SectionCustom Type = module.SectionType Import = module.SectionImport Function = module.SectionFunction Table = module.SectionTable Memory = module.SectionMemory Global = module.SectionGlobal Export = module.SectionExport Start = module.SectionStart Element = module.SectionElement Code = module.SectionCode Data = module.SectionData )
const CustomName = "name"
Variables ¶
var Unwrapped error = section.Unwrapped
Unwrapped may be returned by custom section content loaders.
Functions ¶
func CopyStandardSection ¶ added in v0.32.0
func CopyStandardSection(w io.Writer, l Loader, id ID, customLoader func(r Reader, payloadSize uint32) error) (length int64, err error)
CopyStandardSection with the given type if one is found. The returned length includes the copied section's header and payload (everything that was written). Custom sections preceding the standard section are processed by customLoader (or discarded if it's nil) - they are not included in the returned length. If another standard section type is found, it is left untouched (the reader will be backed up before the section id) and zero length is returned. If no standard section is encountered, zero length and io.EOF are returned. io.EOF is returned only when it occurs between sections.
func CustomLoader ¶ added in v0.32.0
func CustomLoader(loaders map[string]CustomContentLoader) func(Reader, uint32) error
func SkipCustomSections ¶ added in v0.32.0
SkipCustomSections until the next standard section. The skipped sections are processed by customLoader (or discarded if it's nil). If no standard section is encountered, io.EOF is returned. io.EOF is returned only when it occurs between sections.
Types ¶
type ByteRange ¶ added in v0.32.0
ByteRange expresses a location and a length within a byte stream. The length is at most MaxUint32, and the inclusive start and exclusive end offsets are in range [0,MaxInt64].
type CustomContentLoader ¶ added in v0.32.0
type CustomMapping ¶ added in v0.32.0
type CustomMapping ByteRange
func (*CustomMapping) Loader ¶ added in v0.32.0
func (target *CustomMapping) Loader(sectionMap *Map) CustomContentLoader
Loader of arbitrary custom section. Remembers position, discards content.
type CustomSections ¶ added in v0.32.0
type Map ¶ added in v0.32.0
type Map struct {
Sections [module.NumSections]ByteRange
}
Map of section positions within the WebAssebly binary module. Map must me initialied with MakeMap or NewMap.
Section offset is always nonzero for standard sections; if the section is missing, it's the position where it would be. Section length is nonzero if the section is present.
Sections[Custom] holds information about the last (or latest) custom section. Its offset is zero if there are no custom sections.
type MappedNameSection ¶ added in v0.32.0
type MappedNameSection struct {
NameSection
Mapping ByteRange
}
Source Files