blob: 6dce08123bab84a06755842bcd894b48894ec86c (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
<!doctype chapter PUBLIC "-//Davenport//DTD DocBook V3.0//EN" []>
<chapter id="glib-definitions">
<docinfo>
<title>GLIB Definitions and types</title>
</docinfo>
<title>GLIB Definitions and types</title>
<sect1 id="definitions-introduction">
<title>Introduction</title>
<para>GLIB provides many abstract defintions to ease the cross platform
programming tasks. All of these types and definitions have system
specific values that glib, compiled on the native machine will be
adjusted to the system specific types.</para>
<para>By using the following types and defintions in your program, it will
function in the way you designed on more hardware and operating systems
combinations.</para>
<para>We also are provided with definitions for some commonly used macros.
Some of them are only provided if they haven't already been defined. It
is assumed that if they are already defined then the current definition
is correct.</para>
</sect1>
<sect1 id="limit-defines">
<title>Limits</title>
<para>GLIB provides standard definitions for the extremes of many of the
standard types. They are as follows.</para>
<itemizedlist>
<listitem>
<para><type>G_MINFLOAT</type></para>
<para>This is the minimum floating point number that the machine
that your application is running on can handle.</para>
</listitem>
<listitem>
<para><type>G_MAXFLOAT</type></para>
<para>This is the maximum floating point number that the machine
that your application is running on can handle.</para>
</listitem>
<listitem>
<para><type>G_MINDOUBLE</type></para>
<para>FIXME</para>
</listitem>
<listitem>
<para><type>G_MAXDOUBLE</type></para>
<para>FIXME</para>
</listitem>
<listitem>
<para><type>G_MINSHORT</type></para>
<para>FIXME</para>
</listitem>
<listitem>
<para><type>G_MAXSHORT</type></para>
<para>FIXME</para>
</listitem>
<listitem>
<para><type>G_MININT</type></para>
<para>FIXME</para>
</listitem>
<listitem>
<para><type>G_MAXINT</type></para>
<para>FIXME</para>
</listitem>
<listitem>
<para><type>G_MINLONG</type></para>
<para>FIXME</para>
</listitem>
<listitem>
<para><type>G_MAXLONG</type></para>
<para>FIXME</para>
</listitem>
</itemizedlist>
</sect1>
<sect1 id="common-macros">
<title>Commonly used macros</title>
<para>This section details out the commonly used macros that the library
will provide. These definitions will only be provided if they haven't
been defined before.</para>
<itemizedlist>
<listitem>
<para><type>NULL</type></para>
<para>A nothing value.</para>
</listitem>
<listitem>
<para><type>FALSE</type></para>
<para>This macro is used to indicate a non truth.</para>
</listitem>
<listitem>
<para><type>TRUE</type></para>
<para>This macro represents a true value.</para>
</listitem>
<listitem>
<para><type>MAX</type></para>
<para>This macro will return the maximum of two variables.</para>
</listitem>
<listitem>
<para><type>MIN</type></para>
<para>This macro will return the minmum of two variables.</para>
</listitem>
<listitem>
<para><type>ABS</type></para>
<para>This macros will return the absolute value of a signed integer
</para>
</listitem>
<listitem>
<para><type>CLAMP</type></para>
<para>FIXME</para>
</listitem>
</itemizedlist>
</sect1>
</chapter>
|
