/***** World query operations *****/

//! Return the total number of strands (active+stable) in the world
uint32_t @PREFIX@NumStrands (@PREFIX@World_t *wrld);

//! Return the total number of active strands
uint32_t @PREFIX@NumActive (@PREFIX@World_t *wrld);

//! Return the total number of stable strands
uint32_t @PREFIX@NumStable (@PREFIX@World_t *wrld);

//! Return true if there are any recorded error conditions
bool @PREFIX@AnyErrors (@PREFIX@World_t *wrld);

//! Return the pending error message (if any).  This call clears the pending error
//! state.
char *@PREFIX@GetErrors (@PREFIX@World_t *wrld);

/***** Program running operations *****/

//! Allocate the program's world
//! \return the new world or NULL if there are any errors
@PREFIX@World_t *@PREFIX@New ();

//! Initialize the execution state for the world.  This includes allocating processor
//! and GPU resources for parallel execution.
//! \param wrld the world-state of the Diderot program
//! \return true if there are any errors
bool @PREFIX@Init (@PREFIX@World_t *wrld);

//! Initiaize the globals and create the initial set of strands
//! \param wrld the world-state of the Diderot program
//! \return true if there are any errors
bool @PREFIX@Initially (@PREFIX@World_t *wrld);

//! Run the Diderot program
//! \param wrld the world-state of the Diderot program
//! \param maxNSteps the limit on the number of super steps; 0 means unlimited
//! \return the number of steps taken.
uint32_t @PREFIX@Run (@PREFIX@World_t *wrld, uint32_t maxNSteps);

//! shutdown and deallocate the world
void @PREFIX@Shutdown (@PREFIX@World_t *wrld);