Sollya User's Manual

Name:

bashevaluate executes a shell command and returns its output as a string

sollya_obj_t sollya_lib_bashevaluate(sollya_obj_t, ...) sollya_obj_t sollya_lib_v_bashevaluate(sollya_obj_t, va_list)

bashevaluate(command) : string -> string bashevaluate(command,input) : (string, string) -> string

bashevaluate(command) will execute the shell command command in a shell. All output on the command's standard output is collected and returned as a character sequence.
If an additional argument input is given in a call to bashevaluate(command,input), this character sequence is written to the standard input of the command command that gets executed.
All characters output by command are included in the character sequence to which bashevaluate evaluates but two exceptions. Every NULL character ('\0') in the output is replaced with '?' as Sollya is unable to handle character sequences containing that character. Additionally, if the output ends in a newline character ('\n'), this character is stripped off. Other newline characters which are not at the end of the output are left as such.

> bashevaluate("LANG=C date");
Mon Oct 14 12:15:54 CEST 2013

> [| bashevaluate("echo Hello") |];
[|"Hello"|]

   > a = bashevaluate("sed -e 's/a/e/g;'", "Hallo");
   > a;
   Hello