lang.UnmarshalData()
(system API)Converts a Murex data-type into structured memory
, err := lang.UnmarshalData(p, dataType) data
func exampleCommand(p *lang.Process) error {
:= string `{ "foo": "hello foo", "bar": "hello bar" }`
data
:= "json"
dataType
, err := lang.UnmarshalData(p, dataType)
vif err != nil {
return err
}
:= fmt.Sprint(v)
s , err := p.Stdout.Write([]byte(s))
_return err
}
Go source file:
package lang
import (
"fmt"
)
// UnmarshalData is a global unmarshaller which should be called from within
// murex builtin commands (etc).
// See docs/apis/marshaldata.html for more details
func UnmarshalData(p *Process, dataType string) (v interface{}, err error) {
// This is one of the very few maps in Murex which isn't hidden behind a sync
// lock of one description or other. The rational is that even mutexes can
// add a noticeable overhead on the performance of tight loops and I expect
// this function to be called _a lot_ while also only needing to be written
// to via code residing in within builtin types init() function (ie while
// murex is effectively single threaded). So there shouldn't be any data-
// races -- PROVIDING developers strictly follow the pattern of only writing
// to this map within init() func's.
if Unmarshallers[dataType] == nil {
return nil, fmt.Errorf("unknown data type. I don't know how to unmarshal `%s`", dataType)
}
, err = Unmarshallers[dataType](p)
vif err != nil {
return nil, fmt.Errorf("[%s unmarshaller] %s", dataType, err.Error())
}
return v, nil
}
func UnmarshalDataBuffered(parent *Process, b []byte, dataType string) (interface{}, error) {
:= parent.Fork(F_BACKGROUND | F_CREATE_STDIN | F_NO_STDOUT | F_NO_STDERR)
fork defer fork.Kill()
, err := fork.Stdin.Write(b)
_if err != nil {
return nil, fmt.Errorf("cannot write value to unmarshaller's buffer: %s", err.Error())
}
, err := UnmarshalData(fork.Process, dataType)
vif err != nil {
return nil, fmt.Errorf("cannot unmarshal buffer: %s", err.Error())
}
return v, nil
}
*lang.Process
: Process’s runtime state. Typically
expressed as the variable p
string
: Murex data typeMarshal()
(type):
Converts structured memory into a structured file format (eg for
stdio)Unmarshal()
(type): Converts a structured file format into structured
memorylang.MarshalData()
(system API): Converts structured memory into a Murex data-type (eg
for stdio)This document was generated from lang/define_unmarshal_doc.yaml.
This site's content is rebuilt automatically from murex's source code after each merge to the master
branch. Downloadable murex binaries are also built with the website.
Last built on Wed Jan 15 23:07:50 UTC 2025 against commit b4c4296b4c429617fd41527ea0efef33c52c15ef2b64972.
Current version is 6.4.2063 (develop) which has been verified against tests cases.