You are here: Start » Function Reference » All Functions » Process » FisFilter_Execute_StartOnly

FisFilter_Execute_StartOnly

This is Filter Equivalent. This function may be present in generated code, but should not be used in hand-written code.

Header:	STD.h
Namespace:	fis
Module:	FoundationLite

Executes a command using the system console and returns immediately.

Syntax

void fis::FisFilter_Execute_StartOnly
(
	const ftl::File& inCommand,
	const ftl::Array<ftl::String>& inArguments,
	const ftl::Directory& inWorkingDirectory
)

Parameters

Name	Type	Default	Description
inCommand	const File&		System command to be executed.
inArguments	const Array<String>&		Arguments for the command.
inWorkingDirectory	const Directory&	\".\"	Working directory in which the command will be executed.

Description

Filter executes a command provided in inCommand with inArguments arguments. The command will be executed in a directory provided in inWorkingDirectory.

Note: inCommand needs to be an executable file, in contrast to FisFilter_Execute_WaitForExit where it could also be a shell builtin.

Program execution is not blocked: filter does not wait for command completion.

Remarks

Usage of this filter is not recommended in FIL.

Errors

List of possible exceptions:

Error type	Description
DomainError	Could not remember current working directory.
DomainError	Provided inWorkingDirectory is incorrect or not found. Path: provided working directory
DomainError	Provided inWorkingDirectory user provided directory is incorrect or not found.
RuntimeError	Could not return from working directory.
RuntimeError	Could not start process