1 #ifndef __ALT_NO_ERROR_H__
2 #define __ALT_NO_ERROR_H__
3
4 /******************************************************************************
5 * *
6 * License Agreement *
7 * *
8 * Copyright (c) 2004 Altera Corporation, San Jose, California, USA. *
9 * All rights reserved. *
10 * *
11 * Permission is hereby granted, free of charge, to any person obtaining a *
12 * copy of this software and associated documentation files (the "Software"), *
13 * to deal in the Software without restriction, including without limitation *
14 * the rights to use, copy, modify, merge, publish, distribute, sublicense, *
15 * and/or sell copies of the Software, and to permit persons to whom the *
16 * Software is furnished to do so, subject to the following conditions: *
17 * *
18 * The above copyright notice and this permission notice shall be included in *
19 * all copies or substantial portions of the Software. *
20 * *
21 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR *
22 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, *
23 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE *
24 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER *
25 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING *
26 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER *
27 * DEALINGS IN THE SOFTWARE. *
28 * *
29 * *
30 * Altera does not recommend, suggest or require that this reference design *
31 * file be used in conjunction or combination with any other product. *
32 ******************************************************************************/
33
34 /******************************************************************************
35 * *
36 * THIS IS A LIBRARY READ-ONLY SOURCE FILE. DO NOT EDIT. *
37 * *
38 ******************************************************************************/
39
40 #include "alt_types.h"
41
42 #ifdef __cplusplus
43 extern "C"
44 {
45 #endif /* __cplusplus */
46
47 /*
48 * alt_no_error() is a dummy function used by alt_sem.h and alt_flag.h. It
49 * substitutes for functions that have a return code by creating a function
50 * that always returns zero.
51 *
52 * This may seem a little obscure, but what happens is that the compiler can
53 * then optomise away the call to this function, and any code written which
54 * handles the error path (i.e. non zero return values).
55 *
56 * This allows code to be written which correctly use the uC/OS-II semaphore
57 * and flag utilities, without the use of those utilities impacting on
58 * excutables built for a single threaded HAL environment.
59 *
60 * This function is considered to be part of the internal implementation of
61 * the HAL, and should not be called directly by application code or device
62 * drivers. It is not guaranteed to be preserved in future versions of the
63 * HAL.
64 */
65
alt_no_error(void)66 static ALT_INLINE int ALT_ALWAYS_INLINE alt_no_error (void)
67 {
68 return 0;
69 }
70
71 #ifdef __cplusplus
72 }
73 #endif
74
75 #endif /* __ALT_NO_ERROR_H__ */
76
