From ea714e771e8964114285915acacf80707cc17bdd Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Wed, 26 Mar 2025 04:27:39 +0000 Subject: Add export-array; update deps Signed-off-by: Laurent Bercot --- doc/export-array.html | 64 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 doc/export-array.html (limited to 'doc/export-array.html') diff --git a/doc/export-array.html b/doc/export-array.html new file mode 100644 index 0000000..bc3d611 --- /dev/null +++ b/doc/export-array.html @@ -0,0 +1,64 @@ + + + + + + execline: the export program + + + + + + +

+execline
+Software
+skarnet.org +

+ +

The `export-array` program

+ +

+export-array encodes a set of values into an environment variable, +then executes a program. +

+ +

Interface

+ +

+ In an execline script: +

+ +

+     export-array [ -d delim ] var { value1 value2 ... } prog...
+

+ +

export-array reads a (possibly empty) block +of values, and encodes them into the var environment variable. +
It then execs into prog.

+ +

Options

+ +

-d delim : encode the list of values using the +first character of delim as a terminator. Only use this when you know +the character does not appear in any of the values! By default, no terminator +character is specified, and the values are encoded as netstrings.

+ +

Notes

+ +

var must be given without a dollar!
var must not contain the character = .
A list of values encoded via export-array VAR { value1 value2 ... } +can be retrieved via importas -Ssd "" VAR. +Then ${VAR} will be split into as many words as there are values.
A list encoded via export-array -d delim VAR { value1 value2 ... } +can similarly be retrieved via importas -Ssd delim VAR.

+ + + -- cgit v1.3.1

The export-array program

Interface

Options

Notes

The `export-array` program