Stack API

Functions
struct JUNO_DS_STACK_ROOT_TAG	JUNO_MODULE_ROOT (JUNO_DS_STACK_API_T, JUNO_DS_ARRAY_ROOT_T *ptStackArray;size_t zLength;)
	Stack root instance and state.

Detailed Description

A deterministic, fixed-capacity stack (LIFO) backed by a Juno Array. Elements are copied using JUNO_POINTER_T when pushing and popping. Capacity is defined by the backing array. Non-thread-safe by default.

Characteristics:

• O(1) push/pop/peek
• No dynamic allocation; capacity determined by backing array

Invariants:

• 0 <= zLength <= ptStackArray->zCapacity
• Backing array API must be valid (see JunoDs_ArrayVerify)

Error behavior (per implementation):

• Push on full stack: returns JUNO_STATUS_INVALID_SIZE_ERROR
• Pop on empty stack: returns JUNO_STATUS_INVALID_SIZE_ERROR
• Peek on empty stack: returns JUNO_STATUS_INVALID_SIZE_ERROR

Element ownership:

• Elements are copied into/out of the array via the pointer API (Copy), so tItem/tReturn must describe a valid storage location and size.

Function Documentation

JUNO_MODULE_ROOT()

struct JUNO_DS_STACK_ROOT_TAG JUNO_MODULE_ROOT	(	JUNO_DS_STACK_API_T	,
		JUNO_DS_ARRAY_ROOT_T *ptStackArray;size_t zLength;
	)

Stack root instance and state.