• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /* Copyright (C) 2001-2003, 2006-2017, 2019 Free Software Foundation, Inc.
2    Written by Bruno Haible <haible@clisp.cons.org>, 2001.
3 
4    This program is free software; you can redistribute it and/or modify
5    it under the terms of the GNU Lesser General Public License as published by
6    the Free Software Foundation; either version 2, or (at your option)
7    any later version.
8 
9    This program is distributed in the hope that it will be useful,
10    but WITHOUT ANY WARRANTY; without even the implied warranty of
11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12    GNU Lesser General Public License for more details.
13 
14    You should have received a copy of the GNU Lesser General Public License
15    along with this program; if not, see <https://www.gnu.org/licenses/>.  */
16 
17 #ifndef _TEXTSTYLE_STDBOOL_H
18 #define _TEXTSTYLE_STDBOOL_H
19 
20 /* ISO C 99 <stdbool.h> for platforms that lack it.  */
21 
22 /* Usage suggestions:
23 
24    Programs that use <stdbool.h> should be aware of some limitations
25    and standards compliance issues.
26 
27    Standards compliance:
28 
29        - <stdbool.h> must be #included before 'bool', 'false', 'true'
30          can be used.
31 
32        - You cannot assume that sizeof (bool) == 1.
33 
34        - Programs should not undefine the macros bool, true, and false,
35          as C99 lists that as an "obsolescent feature".
36 
37    Limitations of this substitute, when used in a C89 environment:
38 
39        - <stdbool.h> must be #included before the '_Bool' type can be used.
40 
41        - You cannot assume that _Bool is a typedef; it might be a macro.
42 
43        - Bit-fields of type 'bool' are not supported.  Portable code
44          should use 'unsigned int foo : 1;' rather than 'bool foo : 1;'.
45 
46        - In C99, casts and automatic conversions to '_Bool' or 'bool' are
47          performed in such a way that every nonzero value gets converted
48          to 'true', and zero gets converted to 'false'.  This doesn't work
49          with this substitute.  With this substitute, only the values 0 and 1
50          give the expected result when converted to _Bool' or 'bool'.
51 
52        - C99 allows the use of (_Bool)0.0 in constant expressions, but
53          this substitute cannot always provide this property.
54 
55    Also, it is suggested that programs use 'bool' rather than '_Bool';
56    this isn't required, but 'bool' is more common.  */
57 
58 
59 /* 7.16. Boolean type and values */
60 
61 #ifdef __cplusplus
62   /* Assume the compiler has 'bool' and '_Bool'.  */
63 #else
64   /* <stdbool.h> is known to exist and work with the following compilers:
65        - GNU C 3.0 or newer, on any platform,
66        - Intel C,
67        - MSVC 12 (Visual Studio 2013) or newer,
68        - Sun C, on Solaris, if _STDC_C99 is defined,
69        - AIX xlc, if _ANSI_C_SOURCE is defined,
70        - HP C, on HP-UX 11.31 or newer.
71      It is know not to work with:
72        - Sun C, on Solaris, if __C99FEATURES__ is defined but _STDC_C99 is not,
73        - MIPSpro C 7.30, on IRIX.  */
74 # if (__GNUC__ >= 3) \
75      || defined __INTEL_COMPILER \
76      || (_MSC_VER >= 1800) \
77      || (defined __SUNPRO_C && defined _STDC_C99) \
78      || (defined _AIX && !defined __GNUC__ && defined _ANSI_C_SOURCE) \
79      || defined __HP_cc
80    /* Assume the compiler has <stdbool.h>.  */
81 #  include <stdbool.h>
82 # else
83    /* Need to define _Bool ourselves. As 'signed char' or as an enum type?
84       Use of a typedef, with SunPRO C, leads to a stupid
85         "warning: _Bool is a keyword in ISO C99".
86       Use of an enum type, with IRIX cc, leads to a stupid
87         "warning(1185): enumerated type mixed with another type".
88       Even the existence of an enum type, without a typedef,
89         "Invalid enumerator. (badenum)" with HP-UX cc on Tru64.
90       The only benefit of the enum, debuggability, is not important
91       with these compilers.  So use 'signed char' and no enum.  */
92 #  define _Bool signed char
93 #  define bool _Bool
94 # endif
95 #endif
96 
97 /* The other macros must be usable in preprocessor directives.  */
98 #ifdef __cplusplus
99 # define false false
100 # define true true
101 #else
102 # undef false
103 # define false 0
104 # undef true
105 # define true 1
106 #endif
107 
108 #define __bool_true_false_are_defined 1
109 
110 #endif /* _TEXTSTYLE_STDBOOL_H */
111