Spawn.sync

Executes a child synchronously (waits for the child to exit before returning). All output from the child is stored in standard_output and standard_error, if those parameters are non-NULL. Note that you must set the G_SPAWN_STDOUT_TO_DEV_NULL and G_SPAWN_STDERR_TO_DEV_NULL flags when passing NULL for standard_output and standard_error.

If exit_status is non-NULL, the platform-specific exit status of the child is stored there; see the documentation of Spawn.checkExitStatus for how to use and interpret this. Note that it is invalid to pass G_SPAWN_DO_NOT_REAP_CHILD in flags, and on POSIX platforms, the same restrictions as for g_child_watch_source_new() apply.

If an error occurs, no data is returned in standard_output, standard_error, or exit_status.

This function calls Spawn.asyncWithPipes internally; see that function for full details on the other parameters and details on how these functions work on Windows.

class Spawn
static
bool
sync

Parameters

workingDirectory string

child's current working directory, or NULL to inherit parent's

argv string[]

child's argument vector

envp string[]

child's environment, or NULL to inherit parent's

flags GSpawnFlags

flags from GSpawnFlags

childSetup GSpawnChildSetupFunc

function to run in the child just before exec()

userData void*

user data for child_setup

standardOutput string

return location for child output, or NULL

standardError string

return location for child error messages, or NULL

exitStatus int

return location for child exit status, as returned by waitpid(), or NULL

Return Value

Type: bool

TRUE on success, FALSE if an error was set

Throws

GException on failure.