AChildProcess Class Reference

#include <AUI/Platform/AProcess.h>

Public Member Functions#
const auto &	getApplicationFile () const
const auto &	getArgs () const
const auto &	getWorkingDirectory () const
APath	getPathToExecutable () override
AOptional< int >	exitCodeNonBlocking () const noexcept
bool	isFinished () const noexcept
void	run (ASubProcessExecutionFlags flags=ASubProcessExecutionFlags::DEFAULT)
	Launches process.
int	waitForExitCode () override
	Wait for process to be finished.
uint32_t	getPid () const noexcept override
size_t	processMemory () const override
	Obtain process memory usage.
APath	getModuleName () override
const _< IOutputStream > &	getStdInStream () const
AString	toString () const override
Public Member Functions inherited from AProcess
void	kill () const noexcept
Public Member Functions inherited from aui::noncopyable
	noncopyable (const noncopyable &)=delete
noncopyable &	operator= (const noncopyable &)=delete
Public Member Functions inherited from AObject
_< AObject >	sharedPtr ()
_weak< AObject >	weakPtr ()
template<typename Connectable, ACompatibleSlotFor< Connectable > Function>
decltype(auto)	connect (const Connectable &connectable, Function &&function)
	Connects signal or property to slot of "this" object.
void	setSignalsEnabled (bool enabled)
bool	isSignalsEnabled () const noexcept
template<ASignalInvokable T>
void	operator^ (T &&t) noexcept
_< AAbstractThread >	getThread () const
bool	isSlotsCallsOnlyOnMyThread () const noexcept
void	setSlotsCallsOnlyOnMyThread (bool slotsCallsOnlyOnMyThread)
Public Member Functions inherited from AObjectBase
	AObjectBase (AObjectBase &&rhs) noexcept
	AObjectBase (const AObjectBase &rhs) noexcept
AObjectBase &	operator= (const AObjectBase &rhs) noexcept
AObjectBase &	operator= (AObjectBase &&rhs) noexcept

Signals and public fields#
emits	finished
emits< AByteBuffer >	stdOut
emits< AByteBuffer >	stdErr

Additional Inherited Members#
Static Public Member Functions inherited from AProcess
static _< AChildProcess >	create (ProcessCreationInfo args)
	Launches an executable.
static _< AChildProcess >	make (AString applicationFile, AString args={}, APath workingDirectory={})
	Launches an executable.
static int	executeWaitForExit (AString applicationFile, AString args={}, APath workingDirectory={}, ASubProcessExecutionFlags flags=ASubProcessExecutionFlags::DEFAULT)
	Launches executable.
static void	executeAsAdministrator (const AString &applicationFile, const AString &args={}, const APath &workingDirectory={})
	Launches executable with administrator rights. (Windows only)
static AVector< _< AProcess > >	all ()
static _< AProcess >	self ()
static _< AProcess >	findAnotherSelfInstance (const AString &yourProjectName)
	tempFileName file name which will be used as lock
static _< AProcess >	fromPid (uint32_t pid)
Static Public Member Functions inherited from AObject
static void	disconnect ()
template<AAnySignal Signal, aui::derived_from< AObjectBase > Object, ACompatibleSlotFor< Signal > Function>
static decltype(auto)	connect (const Signal &signal, Object *object, Function &&function)
	Connects signal to the slot of the specified object.
template<AAnyProperty Property, aui::derived_from< AObjectBase > Object, typename Function>
static decltype(auto)	connect (const Property &property, Object *object, Function &&function)
	Connects property to the slot of the specified object.
template<APropertyReadable PropertySource, APropertyWritable PropertyDestination> requires requires { { *propertySource } -> aui::convertible_to<std::decay_t<decltype(*propertyDestination)>>; }
static void	connect (PropertySource &&propertySource, PropertyDestination &&propertyDestination)
	Connects source property to the destination property.
template<APropertyWritable PropertySource, APropertyWritable PropertyDestination> requires requires { { *propertySource } -> aui::convertible_to<std::decay_t<decltype(*propertyDestination)>>; { *propertyDestination } -> aui::convertible_to<std::decay_t<decltype(*propertySource)>>; }
static void	biConnect (PropertySource &&propertySource, PropertyDestination &&propertyDestination)
	Connects source property to the destination property and opposite (bidirectionally).
template<AAnySignalOrProperty Connectable, aui::derived_from< AObjectBase > Object, ACompatibleSlotFor< Connectable > Function>
static decltype(auto)	connect (const Connectable &connectable, Object &object, Function &&function)
	Connects signal or property to the slot of the specified object.
template<AAnySignalOrProperty Connectable, aui::derived_from< AObjectBase > Object, ACompatibleSlotFor< Connectable > Function>
static decltype(auto)	connect (const Connectable &connectable, _< Object > object, Function &&function)
	Connects signal or property to the slot of the specified object.
template<AAnySignalOrProperty Connectable, aui::derived_from< AObjectBase > Object, typename Function>
static decltype(auto)	connect (const Connectable &connectable, ASlotDef< Object *, Function > slotDef)
	Connects signal to the slot of the specified object. Slot is packed to single argument.
template<AAnyProperty Property, typename Object, ACompatibleSlotFor< Property > Function> requires (!aui::derived_from<Object, AObject>)
static void	connect (const Property &property, _< Object > object, Function &&function)
	Connects signal or property to the slot of the specified non-AObject type.
static void	moveToThread (aui::no_escape< AObject > object, _< AAbstractThread > thread)
Static Public Member Functions inherited from IStringable
template<typename T>
static AString	toString (const T *t)
template<typename T>
static AString	toString (const _< T > &t)
Static Public Attributes inherited from AObject
static constexpr AObjectBase *	GENERIC_OBSERVER = nullptr
	Indicates that a connection should not be explicitly linked to receiver's lifetime.
Static Public Attributes inherited from AObjectBase
static ASpinlockMutex	SIGNAL_SLOT_GLOBAL_SYNC
Protected Member Functions inherited from AObject
void	setThread (_< AAbstractThread > thread)
	Set thread of the object.
Protected Member Functions inherited from AObjectBase
void	clearAllIngoingConnections () noexcept
virtual void	handleSlotException (std::exception_ptr exception)
	Called then an exception has thrown during slot processing of the signal emitted by this object.

Detailed Description#

Creates child process of this application.

Member Function Documentation#

getModuleName()#

APath AChildProcess::getModuleName ( )

overridevirtual

Returns

process' executable file name.

Implements AProcess.

getPathToExecutable()#

APath AChildProcess::getPathToExecutable ( )

inlineoverridevirtual

Returns

path to the process' executable.

Implements AProcess.

getPid()#

uint32_t AChildProcess::getPid ( ) const

overridevirtualnoexcept

Returns

process' ID.

Implements AProcess.

processMemory()#

size_t AChildProcess::processMemory ( ) const

overridevirtual

Implements AProcess.

toString()#

AString AChildProcess::toString ( ) const

overridevirtual

Returns

string representation of the object

Implements IStringable.

waitForExitCode()#

int AChildProcess::waitForExitCode ( )

overridevirtual

Returns

exit code

Implements AProcess.

© 2025 AUI Framework Contributors. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. All trademarks are property of their respective owners.

Contents

Public Member Functions

Signals and public fields

Additional Inherited Members

Detailed Description

View Page SourceEdit Page Source