/*! \file strands.h
 *
 * \author John Reppy
 */

/*
 * COPYRIGHT (c) 2011 The Diderot Project (http://diderot-language.cs.uchicago.edu)
 * All rights reserved.
 */

#ifndef _DIDEROT_STRANDS_H_
#define _DIDEROT_STRANDS_H_

#ifndef _DIDEROT_TYPES_H_
#include "Diderot/types.h"
#endif

typedef StrandStatus_t (*update_method_t)(void *, void *);
typedef void (*print_method_t)(FILE *, void *);

/* hooks generated by the compiler for the runtime */
typedef struct {
    char		*name;		// name of strand
    size_t		stateSzb;	// sze of strand state
    update_method_t	update;		// update method
    print_method_t	print;		// function for printing output state
} Strand_t;

extern int Diderot_NumStrands;		// the number of strands in the program
extern Strand_t *Diderot_Strands[];	// array of NumStrands strand descriptors

typedef struct struct_world Diderot_World_t;

extern void Diderot_InitGlobals (int argc, const char **argv);
extern Diderot_World_t *Diderot_Initially ();
extern void Diderot_Shutdown (Diderot_World_t *wrld);

/* Diderot library functions */

// block allocation of an initial collection of strands
extern Diderot_World_t *Diderot_AllocInitially (
    Strand_t *strand,		// the type of strands being allocated
    bool isArray,		// is the initialization an array or collection?
    uint32_t nDims,		// depth of iteration nesting
    int32_t *base,		// nDims array of base indices
    uint32_t *size);		// nDims array of iteration sizes

// get strand state pointers
extern void *Diderot_InState (Diderot_World_t *wrld, uint32_t i);
extern void *Diderot_OutState (Diderot_World_t *wrld, uint32_t i);
extern bool Diderot_IsActive (Diderot_World_t *wrld, uint32_t i);

// strand allocation (no initializtion)
extern void *Diderot_AllocStrand (Strand_t *strand);

#endif /* !_DIDEROT_STRANDS_H_ */