WriteArray()
(type)Write a data type, one array element at a time
This is a function you would write when programming a Murex data-type.
It’s called by builtins to allow them to write data structures one array element at a time.
The purpose of this function is to allow builtins to support sequential writes (where possible) and also create a standard interface for builtins, thus allowing them to be data-type agnostic.
WriteArray()
should return a struct
that satisfies the following interface{}
:
package stdio
// ArrayWriter is a simple interface types can adopt for buffered writes of formatted arrays in structured types (eg JSON)
type ArrayWriter interface {
byte) error
Write([]string) error
WriteString(error
Close() }
Registering your WriteArray()
// To avoid confusion, this should only happen inside func init()
/* your type name */, /* your writeArray func */) stdio.RegisterWriteArray(
Example WriteArray()
function:
package string
import (
"github.com/lmorg/murex/lang/stdio"
)
type arrayWriter struct {
writer stdio.Io
}
func newArrayWriter(writer stdio.Io) (stdio.ArrayWriter, error) {
w := &arrayWriter{writer: writer}return w, nil
}
func (w *arrayWriter) Write(b []byte) error {
_, err := w.writer.Writeln(b)return err
}
func (w *arrayWriter) WriteString(s string) error {
byte(s))
_, err := w.writer.Writeln([]return err
}
func (w *arrayWriter) Close() error { return nil }
Since not all data types will be stream-able (for example json
), some types may need to cache the array and then to write it once the array writer has been closed.
package json
import (
"github.com/lmorg/murex/lang/stdio"
"github.com/lmorg/murex/utils/json"
)
type arrayWriter struct {
string
array []
writer stdio.Io
}
func newArrayWriter(writer stdio.Io) (stdio.ArrayWriter, error) {
w := &arrayWriter{writer: writer}return w, nil
}
func (w *arrayWriter) Write(b []byte) error {
append(w.array, string(b))
w.array = return nil
}
func (w *arrayWriter) WriteString(s string) error {
append(w.array, s)
w.array = return nil
}
func (w *arrayWriter) Close() error {
b, err := json.Marshal(w.array, w.writer.IsTTY())if err != nil {
return err
}
_, err = w.writer.Write(b)return err
}
ReadArray()
(type): Read from a data type one array element at a timeReadArrayWithType()
(type): Read from a data type one array element at a time and return the elements contents and data typeReadIndex()
(type): Data type handler for the index, [
, builtinReadMap()
(type): Treat data type as a key/value structure and read its contentsReadNotIndex()
(type): Data type handler for the bang-prefixed index, ![
, builtinThis document was generated from lang/stdio/interface_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 Thu Aug 15 14:38:34 UTC 2024 against commit 50ed9d650ed9d6df391240d3c2c02e623636e508dfcdad1.
Current version is 6.2.4000 which has been verified against tests cases.