Skip to content
CppUtils
Welcome to the new CppUtils documentation!
import CppUtils.System.Process;orimport CppUtils;

CppUtils::System::ProcessStatus

CLASS

Encapsulates the execution status of a child process.

Description

Section titled “Description”

Wraps the POSIX wait status integer and provides friendly inspection methods for exit codes, abnormal termination signals, and detailed diagnostic causes.

Public methods

Section titled “Public methods”
constexpr explicit ProcessStatus::ProcessStatus(int rawStatus = 0) noexcept;

Constructs a ProcessStatus from a raw POSIX wait status integer.

ParameterDescription
rawStatusInteger returned by waitpid / wait.
[[nodiscard]] constexpr auto ProcessStatus::raw() const noexcept -> int;

Returns the raw POSIX status code.

Returns: Raw status integer.

[[nodiscard]] constexpr auto ProcessStatus::isExited() const noexcept -> bool;

Checks if the process terminated normally via exit() or returning from main().

Returns: True if the process exited normally.

[[nodiscard]] constexpr auto ProcessStatus::getExitCode() const noexcept -> int;

Returns the exit code of the process if it terminated normally.

Returns: Exit status integer (0-255).

[[nodiscard]] constexpr auto ProcessStatus::isSignaled() const noexcept -> bool;

Checks if the process was terminated by an unhandled signal.

Returns: True if the process was terminated by a signal.

[[nodiscard]] constexpr auto ProcessStatus::getTerminalSignal() const noexcept -> std::optional<Signal>;

Returns the signal that caused the process to terminate.

Returns: Strongly-typed Signal enumerator.

[[nodiscard]] constexpr auto ProcessStatus::isCoreDumped() const noexcept -> bool;

Checks if the process generated a core dump upon abnormal termination.

Returns: True if a core dump was produced.

[[nodiscard]] constexpr auto ProcessStatus::getTerminalSignalName() const noexcept -> std::string_view;

Returns the symbolic name of the termination signal if signaled.

Returns: Signal name (e.g. “SIGSEGV”), or empty string view if not signaled.

[[nodiscard]] constexpr auto ProcessStatus::getTerminalSignalExplanation() const noexcept -> std::string_view;

Returns a diagnostic explanation of the termination signal if signaled.

Returns: Signal explanation, or empty string view if not signaled or unknown.

[[nodiscard]] auto ProcessStatus::getSignalDescription() const -> std::string;

Formats a comprehensive diagnostic string describing the terminating signal.

Returns: Formatted string such as “SIGSEGV (11) : Segmentation fault (…)”, or empty string if not signaled.