annotate lib/intprops.h @ 421:3c2e1f24cc7d 3.0-beta2

Added generated files for release
author lost@l-w.ca
date Sun, 19 Sep 2010 01:33:24 -0600
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
421
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
1 /* intprops.h -- properties of integer types
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
2
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
3 Copyright (C) 2001, 2002, 2003, 2004, 2005, 2009, 2010 Free Software
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
4 Foundation, Inc.
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
5
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
6 This program is free software: you can redistribute it and/or modify
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
7 it under the terms of the GNU General Public License as published by
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
8 the Free Software Foundation; either version 3 of the License, or
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
9 (at your option) any later version.
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
10
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
11 This program is distributed in the hope that it will be useful,
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
14 GNU General Public License for more details.
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
15
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
16 You should have received a copy of the GNU General Public License
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
17 along with this program. If not, see <http://www.gnu.org/licenses/>. */
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
18
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
19 /* Written by Paul Eggert. */
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
20
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
21 #ifndef GL_INTPROPS_H
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
22 # define GL_INTPROPS_H
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
23
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
24 # include <limits.h>
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
25
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
26 /* The extra casts in the following macros work around compiler bugs,
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
27 e.g., in Cray C 5.0.3.0. */
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
28
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
29 /* True if the arithmetic type T is an integer type. bool counts as
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
30 an integer. */
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
31 # define TYPE_IS_INTEGER(t) ((t) 1.5 == 1)
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
32
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
33 /* True if negative values of the signed integer type T use two's
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
34 complement, ones' complement, or signed magnitude representation,
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
35 respectively. Much GNU code assumes two's complement, but some
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
36 people like to be portable to all possible C hosts. */
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
37 # define TYPE_TWOS_COMPLEMENT(t) ((t) ~ (t) 0 == (t) -1)
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
38 # define TYPE_ONES_COMPLEMENT(t) ((t) ~ (t) 0 == 0)
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
39 # define TYPE_SIGNED_MAGNITUDE(t) ((t) ~ (t) 0 < (t) -1)
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
40
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
41 /* True if the arithmetic type T is signed. */
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
42 # define TYPE_SIGNED(t) (! ((t) 0 < (t) -1))
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
43
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
44 /* The maximum and minimum values for the integer type T. These
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
45 macros have undefined behavior if T is signed and has padding bits.
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
46 If this is a problem for you, please let us know how to fix it for
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
47 your host. */
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
48 # define TYPE_MINIMUM(t) \
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
49 ((t) (! TYPE_SIGNED (t) \
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
50 ? (t) 0 \
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
51 : TYPE_SIGNED_MAGNITUDE (t) \
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
52 ? ~ (t) 0 \
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
53 : ~ (t) 0 << (sizeof (t) * CHAR_BIT - 1)))
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
54 # define TYPE_MAXIMUM(t) \
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
55 ((t) (! TYPE_SIGNED (t) \
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
56 ? (t) -1 \
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
57 : ~ (~ (t) 0 << (sizeof (t) * CHAR_BIT - 1))))
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
58
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
59 /* Return zero if T can be determined to be an unsigned type.
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
60 Otherwise, return 1.
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
61 When compiling with GCC, INT_STRLEN_BOUND uses this macro to obtain a
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
62 tighter bound. Otherwise, it overestimates the true bound by one byte
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
63 when applied to unsigned types of size 2, 4, 16, ... bytes.
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
64 The symbol signed_type_or_expr__ is private to this header file. */
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
65 # if __GNUC__ >= 2
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
66 # define signed_type_or_expr__(t) TYPE_SIGNED (__typeof__ (t))
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
67 # else
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
68 # define signed_type_or_expr__(t) 1
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
69 # endif
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
70
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
71 /* Bound on length of the string representing an integer type or expression T.
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
72 Subtract 1 for the sign bit if T is signed; log10 (2.0) < 146/485;
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
73 add 1 for integer division truncation; add 1 more for a minus sign
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
74 if needed. */
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
75 # define INT_STRLEN_BOUND(t) \
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
76 ((sizeof (t) * CHAR_BIT - signed_type_or_expr__ (t)) * 146 / 485 \
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
77 + signed_type_or_expr__ (t) + 1)
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
78
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
79 /* Bound on buffer size needed to represent an integer type or expression T,
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
80 including the terminating null. */
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
81 # define INT_BUFSIZE_BOUND(t) (INT_STRLEN_BOUND (t) + 1)
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
82
3c2e1f24cc7d Added generated files for release
lost@l-w.ca
parents:
diff changeset
83 #endif /* GL_INTPROPS_H */