Discipline

Functions
SA_API int	SA_create_discipline (const char *discipline_name, tag_t *discipline_tag)
SA_API int	SA_extent_discipline (int *num_disciplines, tag_t **discipline_tags)
SA_API int	SA_find_discipline (const char *discipline_name, tag_t *discipline_tag)

Detailed Description

Function Documentation

SA_API int SA_create_discipline	(	const char *	discipline_name,
		tag_t *	discipline_tag
	)

Creates discipline object. It is not saved to the database until an explicit call to AOM_save occurs. You must specify a discipline name.

Parameters

discipline_name	(I) The name of the Discipline to create.
discipline_tag	(O) The created Discipline.

SA_API int SA_extent_discipline	(	int *	num_disciplines,
		tag_t **	discipline_tags
	)

Retrieves all the Discipline objects defined in the system.

Parameters

num_disciplines	(O) The number of Disciplines in the system.
discipline_tags	(OF) Array of Disciplines objects.

SA_API int SA_find_discipline	(	const char *	discipline_name,
		tag_t *	discipline_tag
	)

Finds a discipline with the specified name. The discipline name is unique in the database. If no Discipline exists with the specified name, a NULLTAG returns for the discipline tag.

Parameters

discipline_name	(I) The name of the Discipline to search for.
discipline_tag	(O) Reference to the Discipline object found. If not found, this will be NULLTAG.