Aluminium

System Operations

deserialize

Deserializes data that was serialized with the serialize operation (i.e. returns exactly the same data that was serialized).

Arguments:

:data*
Binary object to be deserialized.

file_input

Reads contents of a file.

Arguments:

:file
Name of the file. If it's not specified, stdin is used.
:encoding
Encoding of the (text) file. If it's not specified, data is read without conversion (i.e. binary data). List of supported codecs can be found here.

file_output

Writes data to a file.

Arguments:

:file
Name of the file. If it's not specified, stdout is used.
:data*
Data to be written.
:encoding
Encoding of the (text) file. If it's not specified, data is written without conversion (i.e. binary data).

getenv

Returns the value of an environment variable.

Arguments:

:name*
Name of the environment variable.

serialize

Serializes data of any type and structure into a binary object to be written to a file or passed via network.

Arguments:

:data*
Data to be serialized.

system

Executes an external program and returns the data that program has written to its' standard output.

Arguments:

:command*
Name of the program.
:data
Data that will be written to the programs' standard input. This argument is optional.
:encoding
If data is given to be passed to the program, this argument can be used to set the encoding used to encode the data. If it's not specified, data will be written without conversion.
:decoding
If this argument is given, data returned from process's standard output will be decoded using this encoding; otherwise the data won't be transformed.