Library: Process execution (OMPROCESS) Import: omprocess.xmd

Return type: command-line-type Returns: Command-line object representing the provided STRING argument.

Declaration

export command-line-type function
        command-line              value string c-line
                     with-parsing value switch parsing optional initial { true } 

Argument definitions

c-line

is the command-line string to be processed

parsing

indicates whether or not the command-line should be split into whitespace-delimited components

The command-line function takes a full command-line in string form, and builds a representation of that command-line that can be used to launch a process using the execute function.

The optional parsing argument can be used to guide OmniMark into breaking up the components of the command-line into individual pieces. If the argument is true (the default when it is left unspecified), quoted strings in the command-line are processed as follows:

1. Any whitespace character is escaped if it appears within a sequence delimited by a pair of matching quote characters (either single or double).
2. The matching quote characters referred to above are removed.
3. The resulting string is split on any remaining, unescaped whitespace.

If the argument is false, the command-line is not processed. Loosely speaking, true corresponds to how most Unix shells parse their command-line. However, note that command-line processing is ultimately platform-dependent. Use of the command-line function can yield different results on different platforms, once the returned value is passed on to the execute function.

Related Topics omprocess-version executable-name execute glob

Other Library Functions command-line executable-name execute glob omprocess-version

[ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACY LIBRARIES ] [ ERRORS ]