Qu

shell

Builtin index · File I/O

result = shell(command, [style])

Input: command, style · Output: result

What it is

Hands command (a Str) to the OS shell and returns immediately, without waiting — Visual Basic's Shell, which is where the window styles come from too. style (an optional Str, positional or style=) is one of "normal" (the default), "hidden" (also spelled "ghost"), "minimized" or "maximized".

Overloads

One call shape — this function is not overloaded.

CodeInputOutputDescription
result = shell(command, [style])
command StrHands command (a Str) to the OS shell and returns immediately, without waiting — Visual Basic's Shell, which is where the window styles come from too.
style Str, optionalstyle (an optional Str, positional or style=) is one of "normal" (the default), "hidden" (also spelled "ghost"), "minimized" or "maximized".
result Num
Returns a Num: the process id.

Examples

No documentation example calls this form yet. The File I/O chapter is where one belongs.

How it works

module's own doc comment for why running a program and launching one are two builtins rather than one. Both are on check_sandbox's deny list, and the single guard at the top of this function is what applies it. Calling it again HERE would deny them always, sandboxed or not -- that guard is the only place self.sandboxed is read.

From the note above this builtin in the interpreter, where the reasoning was written down as it was built.