1 /*
2  * The copyright in this software is being made available under the 2-clauses
3  * BSD License, included below. This software may be subject to other third
4  * party and contributor rights, including patent rights, and no such rights
5  * are granted under this license.
6  *
7  * Copyright (c) 2008, Jerome Fimes, Communications & Systemes <jerome.fimes@c-s.fr>
8  * All rights reserved.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions
12  * are met:
13  * 1. Redistributions of source code must retain the above copyright
14  *    notice, this list of conditions and the following disclaimer.
15  * 2. Redistributions in binary form must reproduce the above copyright
16  *    notice, this list of conditions and the following disclaimer in the
17  *    documentation and/or other materials provided with the distribution.
18  *
19  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS `AS IS'
20  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22  * ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
23  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29  * POSSIBILITY OF SUCH DAMAGE.
30  */
31 
32 #ifndef __FUNCTION_LIST_H
33 #define __FUNCTION_LIST_H
34 
35 /**
36  * @file function_list.h
37  * @brief Implementation of a list of procedures.
38 
39  * The functions in validation.c aims to have access to a list of procedures.
40 */
41 
42 /** @defgroup VAL VAL - validation procedure*/
43 /*@{*/
44 
45 /**************************************************************************************************
46  ***************************************** FORWARD DECLARATION ************************************
47  **************************************************************************************************/
48 
49 /**
50  * declare a function pointer
51  */
52 typedef void (*opj_procedure)(void);
53 
54 /**
55  * A list of procedures.
56 */
57 typedef struct opj_procedure_list
58 {
59 	/**
60 	 * The number of validation procedures.
61 	 */
62 	OPJ_UINT32 m_nb_procedures;
63 	/**
64 	 * The number of the array of validation procedures.
65 	 */
66 	OPJ_UINT32 m_nb_max_procedures;
67 	/**
68 	 * The array of procedures.
69 	 */
70 	opj_procedure * m_procedures;
71 
72 } opj_procedure_list_t;
73 
74 /* ----------------------------------------------------------------------- */
75 
76 /**
77  * Creates a validation list.
78  *
79  * @return	the newly created validation list.
80  */
81 opj_procedure_list_t *  opj_procedure_list_create(void);
82 
83 /**
84  * Destroys a validation list.
85  *
86  * @param p_list the list to destroy.
87  */
88 void  opj_procedure_list_destroy(opj_procedure_list_t * p_list);
89 
90 /**
91  * Adds a new validation procedure.
92  *
93  * @param	p_validation_list the list of procedure to modify.
94  * @param	p_procedure		the procedure to add.
95  *
96  * @return	OPJ_TRUE if the procedure could be added.
97  */
98 OPJ_BOOL opj_procedure_list_add_procedure (opj_procedure_list_t * p_validation_list, opj_procedure p_procedure);
99 
100 /**
101  * Gets the number of validation procedures.
102  *
103  * @param	p_validation_list the list of procedure to modify.
104  *
105  * @return the number of validation procedures.
106  */
107 OPJ_UINT32 opj_procedure_list_get_nb_procedures (opj_procedure_list_t * p_validation_list);
108 
109 /**
110  * Gets the pointer on the first validation procedure. This function is similar to the C++
111  * iterator class to iterate through all the procedures inside the validation list.
112  * the caller does not take ownership of the pointer.
113  *
114  * @param	p_validation_list the list of procedure to get the first procedure from.
115  *
116  * @return	a pointer to the first procedure.
117  */
118 opj_procedure* opj_procedure_list_get_first_procedure (opj_procedure_list_t * p_validation_list);
119 
120 
121 /**
122  * Clears the list of validation procedures.
123  *
124  * @param	p_validation_list the list of procedure to clear.
125  *
126  */
127 void opj_procedure_list_clear (opj_procedure_list_t * p_validation_list);
128 /*@}*/
129 
130 #endif /* __FUNCTION_LIST_H */
131 
132