luadocs/content/lua.scripts.api.manual/dtutils.system/windows_command.md
Bill Ferguson b69d752221 [lua scripts] created manual from script comments
[lua scripts api] created manual from embedded library documentation

[lua api] created stub to contain lua api manual
2020-12-12 15:14:19 -05:00

898 B

title id weight draft author
windows_command windows_command 40 false people

NAME

windows_command

SYNOPSIS

pass a command to the windows operating system for execution and return the result

USAGE

local dsys = require "lib/dtutils.system"
local result = dsys.windows_command(command)

command - string - a string containing the command and arguments to be passed to the operating system for execution.

DESCRIPTION

The normal method of executing an operating system command is using dt.control.execute(), but that doesn't work with Windows when more than one item in the command is quoted. In order to ensure command execution on Windows we create a batch file in the temporary directory, put the command in it, execute the batch file, then return the result.

RETURN VALUE

result - number - the return value signalling success or failure.