kcenon::thread::jobs Namespace Reference

Classes
class	job_interface
	Interface for executable job objects. More...

Typedefs
using	job_ptr = std::shared_ptr<job_interface>
	Shared pointer type for job objects.
using	job_weak_ptr = std::weak_ptr<job_interface>
	Weak pointer type for job objects.
using	job_function = std::function<void()>
	Function type for simple callback-based jobs.

Enumerations
enum class	job_priority : uint8_t { low = 0 , normal = 1 , high = 2 }
	Job priority levels for type-based scheduling. More...
enum class	job_state : uint8_t {   pending , running , completed , cancelled ,   failed }
	Job execution states. More...

Functions
job_priority	make_priority (int priority_value)
	Utility function to create a job priority from integer.
std::string	to_string (job_priority priority)
	Convert job priority to string representation.
std::string	to_string (job_state state)
	Convert job state to string representation.

Typedef Documentation

job_function

using kcenon::thread::jobs::job_function = std::function<void()>

Function type for simple callback-based jobs.

Definition at line 94 of file job_types.h.

job_ptr

using kcenon::thread::jobs::job_ptr = std::shared_ptr<job_interface>

Shared pointer type for job objects.

Definition at line 84 of file job_types.h.

job_weak_ptr

using kcenon::thread::jobs::job_weak_ptr = std::weak_ptr<job_interface>

Weak pointer type for job objects.

Definition at line 89 of file job_types.h.

Enumeration Type Documentation

job_priority

enum class kcenon::thread::jobs::job_priority : uint8_t

strong

Job priority levels for type-based scheduling.

Enumerator
low	Low priority jobs (background tasks)
normal	Normal priority jobs (regular tasks)
high	High priority jobs (urgent tasks)

Definition at line 22 of file job_types.h.

                            : uint8_t {
        low = 0,      
        normal = 1,   
        high = 2      
    };

job_state

enum class kcenon::thread::jobs::job_state : uint8_t

strong

Job execution states.

Enumerator
pending	Job is waiting to be executed.
running	Job is currently being executed.
completed	Job has completed successfully.
cancelled	Job was cancelled before execution.
failed	Job execution failed.

Definition at line 31 of file job_types.h.

                         : uint8_t {
        pending,      
        running,      
        completed,    
        cancelled,    
        failed        
    };

Function Documentation

make_priority()

job_priority kcenon::thread::jobs::make_priority ( int priority_value )

inlinenodiscard

Utility function to create a job priority from integer.

Parameters

priority_value

Integer priority (0=low, 1=normal, 2=high)

Returns

Corresponding job_priority enum value

Definition at line 101 of file job_types.h.

                                                                        {
        switch (priority_value) {
            case 0: return job_priority::low;
            case 1: return job_priority::normal;
            case 2: return job_priority::high;
            default: return job_priority::normal;
        }
    }

References high, low, and normal.

to_string() [1/2]

std::string kcenon::thread::jobs::to_string ( job_priority priority )

inlinenodiscard

Convert job priority to string representation.

Parameters

priority

Job priority to convert

Returns

String representation of the priority

Definition at line 115 of file job_types.h.

                                                                    {
        switch (priority) {
            case job_priority::low: return "low";
            case job_priority::normal: return "normal";
            case job_priority::high: return "high";
            default: return "unknown";
        }
    }

References high, low, normal, and kcenon::thread::priority.

to_string() [2/2]

std::string kcenon::thread::jobs::to_string ( job_state state )

inlinenodiscard

Convert job state to string representation.

Parameters

state

Job state to convert

Returns

String representation of the state

Definition at line 129 of file job_types.h.

                                                              {
        switch (state) {
            case job_state::pending: return "pending";
            case job_state::running: return "running";
            case job_state::completed: return "completed";
            case job_state::cancelled: return "cancelled";
            case job_state::failed: return "failed";
            default: return "unknown";
        }
    }

References cancelled, completed, failed, pending, and running.