inmatprop.h File Reference

---

Detailed Description

Input matrix properties collection and inspection.

This module implements facilities that help collect, record, and examine the input matrix properties specified by the user when she creates the matrix handle.

Header file dependencies:

• oski/userconst.h

#include <assert.h>
#include <stdarg.h>
#include <oski/userconst.h>

Go to the source code of this file.

Data Structures
struct	oski_inmatpropset_t
	Collected input matrix property settings. More...
Defines
#define	INC_OSKI_INMATPROP_H
	inmatprop.h has been included.
#define	INMATPROP_UNDEFINED   (int)(INMATPROP_NULL)
	Property undefined.
#define	MIN_INMATPROP   MAT_GENERAL
	Smallest value of the enumerated type, oski_inmatprop_t.
#define	MAX_INMATPROP   (INMATPROP_MAX-1)
	Largest value of the enumerated type, oski_inmatprop_t.
Functions
void	oski_ClearInMatPropSet (oski_inmatpropset_t *props)
	Initialize property set with "unset" values.
void	oski_CompleteDefaultInMatPropSet (oski_inmatpropset_t *props)
	Complete unitialized properties with default values.
int	oski_IsInMatPropSetConsistent (const oski_inmatpropset_t *props)
	Checks an input matrix property set for consistency.
void	oski_DisplayInMatPropSet (const oski_inmatpropset_t *props)
	Display an input matrix's asserted properties (FOR DEBUGGING ONLY).
int	oski_CollectInMatProps (oski_inmatpropset_t *props, int k,...)
	Collect input matrix properties.
int	oski_CollectInMatProps_va (oski_inmatpropset_t *props, int k, va_list ap)
	Explicit variable argument version of oski_CollectInMatProps().
int	oski_CollectInMatProps_arr (oski_inmatpropset_t *props, int k, const oski_inmatprop_t *in_props)
	Explicit property-array version of oski_CollectInMatProps().

---

Define Documentation

#define INMATPROP_UNDEFINED   (int)(INMATPROP_NULL)

Property undefined. This macro defines a special value used to denote that an input matrix property has not yet been defined. See also: oski/userconst.h oski_inmatprop_t

---

Function Documentation

void oski_ClearInMatPropSet (  oski_inmatpropset_t *  props  )

Initialize property set with "unset" values. Parameters: [out]  props  Property data structure to initialize. Precondition: props != NULL See also: oski_inmatpropset_t

int oski_CollectInMatProps (  oski_inmatpropset_t *  props, int  k,   ... )

Collect input matrix properties. Assuming the caller has a variable input argument list, this macro parses these arguments and collects them in an instance of oski_inmatpropset_t. Parameters: [in]  k  The number of remaining arguments. [out]  props  A pointer to an instance of oski_inmatpropset_t. Its values will be overwritten by the call to this macro. Returns: A cleared 'props' structure, and returns 0 if no error occurs. See also: oski_inmatpropset_t, oski_inmatprop_t.

void oski_CompleteDefaultInMatPropSet (  oski_inmatpropset_t *  props  )

Complete unitialized properties with default values. Parameters: [in,out]  props  Property data structure to complete. Precondition: props != NULL See also: oski_inmatpropset_t Postcondition: Checks the final property set for consistency, and aborts the program if it is not.

void oski_DisplayInMatPropSet (  const oski_inmatpropset_t *  props  )

Display an input matrix's asserted properties (FOR DEBUGGING ONLY). Parameters: [in]  props  Asserted input matrix property set. Precondition: props != NULL Note: This routine executes only if the debugging level is 3 or higher.

int oski_IsInMatPropSetConsistent (  const oski_inmatpropset_t *  props  )

Checks an input matrix property set for consistency. Parameters: [in]  props  Input matrix properties specified. Returns: 0 if there is some detected inconsistency in the input matrix property specification, or 1 otherwise. Precondition: props != NULL.

---